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1,0 INTRODUCTION 



i.o iiiiEQaycuaii 

The NOS/VE Cycle 18 Software Release Bulletin (SRB) Is to fee used 
ml th the NOS/VE Installation and Upgrade Manual (604639131 for 
Installing Control Data Corporation systems. Control Oata recommends 
that the SRB be read In its entirety prior to software Installation* 

1.1 S£Q££ 

The SRB is the vehicle to document any changes to the Installation 
and Upgrade Manual after it has gone to print and any system 
deficiencies* It is necessary to install NOS 2*2 Level 602 and Level 
587 of the Common Products before installing NOS/VE* 

1.2 COMIEMI 

This document contains Information to be used in Installing NOS/VE 
Cycle 18 with the Level IV Product Set* Sections of this document 
Include 1) installing the system* 2) operating system notes and features 
including undocumented commands and knonn system deficiencies* 3) 
product set notes and features* and 4) an appendix containing NOS/VE 
Peripheral Maintenance Support information* 



- COMPANY PRIVATE 



2-1 
SOFTWARE RELEASE BULLETIN 

84/03/12 
NOS/VE {CYCLE 18) 

2.0 FEATURES ANO PRODUCTS 



2.0 ££AXliR££_Ai£&_£EO&ym 

A description of Operating System and Product Set features way be 
found in the NOS/VE 1.0 Software Availability Bulletin CSAB). Please 
refer to that document for NOS/VE Cycle 18 system feature information. 

All references In the NOS/VE 1.0 SAB to the CYBER 170-835 and CYBER 
170-855 should be updated to include the CYBER 170-815, CYBER 170-825# 
and CYBER 170-8*5. All references In the NOS/VE 1.0 SAB to NOS 2,1 
Level 588 should be modified to NOS 2.2 Operating System Level 596 and 
Common Product Level 602. 

The release materials for NOS/VE Cycle 18 include the following 
software products. 

Product Name External Identification 



. NOS/VE Deadstart Generation and • NOS/VE - 01 
Modification Package 

• NOS/VE System Core and Job Template Nemory • Haintenance 
Image NaJntenance 

. COBOL for NOS/VE . NOS/VE - 02 

. SORT/HERGE Utility . NGS/VE - 03 

• Required Products . NOS/VE - 04 
. File Hanagement Utility . NOS/VE - 05 
. FORTRAN for NOS/VE . NOS/VE - 06 

• CYBER Implementation Language • NOS/VE - 07 
. NOS/VE On Line Hanuals . NOS/VE - 08 
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The list of NOS/VE Reference Manuals includes the following: 
Operating System Manuals Publication Number 



System Command Language for NOS/VE Language 
Definition Usage 

System Command Language for NOS/VE System 
Interface Usage 

System Command Language for NOS/VE + online 
Guick Reference 

Source Code Utility for NOS/VE + online 

Usage 

Object Code Management for IIOS/VE ♦ online 
Usage 



CYBIL Manuals 

CYBIL for NOS/VE Language Definition Usage 
CYBIL for NOS/VE File Interface Usage 
CYBIL for NOS/VE System Interface Usage 

FORTRAN Manuals 

FORTRAN for NOS/VE + online Usage 

COBOL Manual 



60464013 
60464014 
60464018 
60464313 
60464413 

Publication Number 

60464113 
60464114 
60464115 

Publication Number 



60485913 



Publication Number 



COBOL for NOS/VE + online Usa^e 



File Nanagement Utility for NOS/VE Usage 
Sort/Merge Utility for NOS/VE * online Usage 



60486013 



Language-Independent Tools/Utilities Manuals Publication Number 



60486413 
60486113 
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Hath Library for NOS/VE Usage 

Family Administration for NOS/VE Usage 

Migration Aid 



Migration 'Guide for NOS to HOS/VE + online 



Error Massages 



Diagnostic Messages for NOS/VE + online 



Si te Manuals 



NOS/VE Installation and Upgrade Usage 
NOS/VE Operations Usage 



604865X3 
60464513 

Publication Number 

60489503 
Publication Number 

60464613 

Publication Number 

60463*113 
60463914 
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3 . ia$IALUIIQii-4aa-Q£££AII£M-!iflXE£ 



3.1 IMilALLAIIOH 

3.1.1 NOS INSTALLAT 

1* The NOS User Name creation described in the NQS/VE Install at ion 
and Upgrade Manual implies that the default M09VAL DS value is 
adequate* DS*5 Is the appropriate value* 
PSR NV00011 

2* PASSON and IRHF both run out of the SYSTEHX account* Because of 
this* the password must be set to SYSTEMX and the resource 
validations must be set to their maximum. 
PSR NVOOO02 

3* The "UN** parameter on the *SETVE* command must have its resource 
validations set to the a ax I num. Failure to do this can cause the 
deadstart job to fail with »PRU IIHIT* or «SRU LIHIT 1 . 
PSR NV00002 

3.1.2 CONTROUfARE INSTALLATION 

1* To install the 7155 Disk controlware the following process must be 
f ol loved* 

a* Copy the Controlware card deck to direct access file FHDBIN 
in a NOS user number* 

b* Create indirect access file CMFHO containing the line 

*CQHHEHTbPPU/FnDb885feFIRMWAREbHA721-A09{PN67185849)bYY/MM/DD 
where b represents a space and YY/MM/DD should be filled In 
with the appropriate date. 

c* Return both flies* 

d* Create file GENFMD containing the fol lowing procedures 

.PRQC#GENFH0. 

GETfCUFHD. 

ATTACH* INH0LD*FHD8IN. 

REWIND* INHQLD. 

RFL.5O000. 

RBR(XNHQLDjFHD) (the second argument here nust match the PPU 
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name in the comment card) 

*8RfLG0) 

LIBEDITiP»L£O.8»0*I*CWFHD#L»0»N»FHD) 

e. Run this procedure from the NOS terminal. Note that this 
sequence of commands must be run »s a procedure and Mill not 
work if typed in as Individual commands at the terminal • 

f. The resultant file FMD may fee saved or written to tape and 
made part of the NOS Deadstart tape via Libedit or Sysedit. 

3.1.3 INSTALLATION OF LARGE SECTOR FHD DIAGNOSTICS 

Installation of the CHL L160 can be done the same way CNL 1155 was 
installed with the addition of the 885LS parameter . The Installation 
process is described in Section 1 of the CHL Reference Manual 
publication 60455980# Rev.K. The parameter 885LS for large sector 885 
disk drives ks described below* The device code for 885 large sector is 
16 octal. 

(This item goes with Table 1-3 Hardware Configuration Parameters 
sheet 3 of 3 on page 1-19 of the above mentioned CNL Reference Manual. 

Parameter Name Used In Job Function 

885LS CHL2#CHL5 Specifies that large sector 



disk drives are included in 
the system configuration. Causes 
MALET diagnostics FLD and DL8 
to be loaded and saved. Will also 
cause FMC and FNU to be loaded 
and saved If not done through the 
inclusion of other parameters. 
(7155/885/DENH). 

3.1.4 NOS/VE INSTALLATION 

1. The description of Release Materials in section 1 of the 
Installation Handbook for NOS/VE 1.0.2 is incorrect* 

The tape described as N0S/.VE-04 is actually labelled PRODUCTS # 
but still contains the required NOS/VE products. 

The tape labelled N0S/VE-§4 contains the Online Manuals and Is an 
optional tape. It is a 180 tape written by the 
Sackup_Permanent.FI ies utility and contains 15 files which 
comprise the SSYSTEM product subcatalog. They %re loaded via the 
Restore.Pernanent.Fl les uti 1 i ty. 
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2. Several operational problems have been encountered by sites when 
maintaining their s$SYSTEM.$SYSTEH files using the 
BACKUP.PERHANENT..FILE and RESTORE_PERHANENT_FILE utilities. These 
problems occur due to various files which are created during 
NQS/VE deadstart. The problems which arise* and the appropriate 
remedial action are described below* 

a. Circumstances arise where an INSTALLATION deadstart is 
necessary followed by restoration of the permanent file base 
using the RESTGRE_PERNANENT J=ILE utility. When deadstart 
has completed* the following permanent files may have been 
created* 

uuu.$FAHILY_US£R5 - This file is created during processing 
of the Initialization prolog. The content of this file 
typically does not match the current validation contained 
on a site's archived permanent file base. Remedial actions 
See the next Item in this section describing the required 
remedial action. 
PSR MV00113 

SYST£H_PRQLOG and SYSTEN.EPUQG - These files are also 
created during Initialisation prolog processing. 
Corresponding SUPPLEMENT files are created as well* Any 
changes a site may have made to these files which reside in 
catalog $SYSTEH.PRQLOGS_ANDJEPILOGS will be lost. Remedial 
action: Until adequate provisions are made for maintaining 
and upgrading these files* it is recommended that the 
family user administrator provide user prolog and user 
epilog files which reflect the processing performed during 
user LOGIN and LOGOUT. These user prolog and epilog files 
are associated with family users by the S£T_USER_PRGLGG and 
$ETJJ$ER_EPILGG commands of the ADHINI$TER_U$ER utility. 
PSR NV00C24 

System Libraries - These files are created from files 
loaded from the NQS/VE deadstart file whenever the system 
core commands INITIAL! ZEJ)EADSTART_DEVICE or 
SET^SYSTE^ATTRIByTE LOA0FILES 1 are processed. They 
Include the following files* 

t$SYSTEM.$SYST£M.0SF$np£RAT0R_LI8RARY.$NEXT 
s$$YSTEN*$SYST£H.O$F$aP£RATQR_C0HMAND_LIBRARY.$N£XT 
:$$YSTEH.$5YSTEM.G$F$CGHHAND_LI8RARY.$N£XT (Boot Version) 
*$$YST£H.$SY$T£H.OSF s SSYSTEH. $SYSTEH_LIBRARY.$NEXT 
f$$YST£N.$$YSTEH.O$F$SITEj:OHHAND_LIBRARY.$NEXT 
«$$YSTEW.$SYSTEH.CY8IL.CYF$R!JN_TIH£_LIBRARY.$NEXT 
*$3YSTEN.$SYSTE$.0CU.aGUNDJ>R0DUCT.$N£XT (Boot Version) 
Any changes to these files must also be made to NOS/VE 
deadstart file* otherwise they will be lost when NQS/VE is 
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deadstarted. Operational problems arise with the files 

Identified above as "Boot Version** files* These ••Boot 

Version" files contain skeletal versions of the system 

command library and QbJect_Code_Utl 1 1 ties which are 

required for deads tart to complete normally. The fully 

Installed version of these files is required for normal 

NOS/VE usage. Since these flies are created during 

deadstart* they Mill not be restored during subsequent 

execution of the RESTORE. PERHANENT_FIL£ utility. Remedial 

action* Either rerun the RESTQRE_PERNANENT_FILE utility and 

specify the REST0RE_EXISTIN6_FILES directive for these 

files* or specify 3ET_SYST£M_ATTRIBUTE LOADFILES 1 and 

S£T_SYSTEH_4TTRIBUTES HULTO 1 during a CONTINUATION 

deadstart* and reload the NOS/VE required products tape 

when the NEXTDSTAPE response Is requested. 

b. yhen any of the system libraries have changed on the NOS/VE 

deadstart file* It Is necessary to specify 

SET_SYSTEN_ATTRXBUTE LOADFILES 1 during a CONTINUATION 

deadstart. Again* the "Boot Version** files are created 

which are inappropriate for a production workload. Remedial 

actions Either delete cycle $HIGH of the ••Boot Version" 

files* or specify SET_SYSTEH_ATTRI8UT£ HULTD 1 and reload 

the required products tape when the NEXTDSTAPE response is 

requested during deadstart. 

The problems associated with "Boot Version* 1 files will be 
corrected in a future release. 
PSR NV00077 

3. Automated validation performed during an INSTALLATION deadstart 
creates a $FAHILY_USERS file for the NVE family. If you 
subsequently reload permanent files to family NVE from a 
8ACKUP_PERiiANENT_FILE file* catalogs which were not defined in the 
automated validation cannot be accessed. Likewise* any catalog 
information which has not been updated in the automated validation 
file is incorrect for the catalogs restored using 
R£STORE.PER!tAMENT_FILE. The recommended sequence of events In 
which an installation deadstart can be performed* »n^ the family 
NVE permanent files restored from a previous level is as follows* 

a. 8ACKUPJ>ERt1ANENT..FILE all NVE catalogs and files to tape in 
a task that runs in ring 3 from a Job other than the system 
job (consols) that runs under SSYSTEH. This is done by 
bracketing the commands associated with the backup with 
TASK# TASKEN0 commands* The ring number Is established by 
using the RING parameter of the TASK command. For example* 
type from the console* 
408* BACKUP 

REQMTjDUrll*.* •« 

T*MT9/46E5C*R1NG-0N*EVSN»C/*01/*) 
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TASK*RIN6»3 
BA€PF#BF«DUNP 

BACAF 
QUIT 
TASKENO 
J0BEN9 
NOTE* The task command can be specified oniy in an 
Interactive Job or in a batch Job running under SSYSTEH* 
b* Perform an Installation Deadstart of NOS/VE* but enter the 
command GO rather than AUTO to terminate System Core command 
processing* An additional pause for operator intervention 
occurs Just prior to the loading of system libraries from 
the NOS/VE deadstart file. Enter the command OETF 
VALIDATE/0FAMILY/ONVE prior to entering the NEXTDSTAPE or €0 
response which causes deadstart processing to resume* This 
command will disable automated validation* 
c* Restore the $FAflILY_US£RS file that Mas backed up in step a* 
(If you failed to disable validation prior to this step* you 
must LOGIN as the NVE family user administrator* and change 
the name of the $FAHILY_US£RS file using 
Change^Catalog^Entry. ) 
d* Restore the remaining NVE family files which were backed up 

in step 1* 
e* Execute the Create_Fami ly command from the operator console 
P'SR NV00079 

4* The procedure Verify.Instal led_Software which is documented in the 
NOS/VE Installation and Upgrade manual I Publication number 
60463913 A) is not available at this time* 

5* Multiple NOS/VE upgrades using the CREAT£_J08_TEHPLATE command 
result In a large number of files being created on the deadstart 
disk* Each successful execution of the CREAT£_JQ8_TEMPLATE 
command creates a directory file and several uniquely named 
segment files. The directory flie name is specified by the 
TEHPLATEJNANE parameter* mndi contains the name of every segment 
file which constitutes the Job template* Whenever a Job template 
is no longer being used* the DELETE.*) OB_TENPLATE command should be 
used to remove the directory file from the deadstart disk* 
Segment files are removed by this command whenever the directory 
file is removed* The console entry for this command is* 

K*DEL£T£/CMGB/0TEMPLA?£ TN*name 

PSR NV00023 

6* Online manuals are released on t NOS/VE BACKUP.PERHANENT.FILE tape 

at this release* In a future release of NOS/VE* all products will 

be released in this format. To install the online manuals at this 

release level, you must reload the files on this tape into the 
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$SYSTEH. MANUALS subcatalogs of the SSYSTEM family. Create the 
following NOS/VE job to accomplish this task* 

JOB* RESTORE 

retiuest.i9agnotIc.tape file*backup type*mt9$1600 •* 
rlng»no evsn*nveO04 

WHEN any.fault 00 

display.value osv$status output*$response 

request.operator.actlon message** RESTORE FAILED - CHECK TAPE* 

LOGOUT 
WHENED 

RESTORE.PERHANENT.FUE 

restore. al l.fi I es backup.fi le*backup 
QUIT 

J08END 

The above job may be created as a HOS or NOS/VE text file. This 
text file is then accessed from the operator console* using the 
ATTACH.FILE or GET.FILE cowhand, and the INCLUDE.FILE command is 
executed to submit this job as a SSYSTEN family batch Job. 

7. Remote installation mr\^ maintenance of the operating system 
requires assistance from the operator's console. The installation 
and maintenance procedures Bte being modified to reduce the ne%4 
for assistance at the console. Until Remote Deadstart is 
available* this n^ed will not be totally eliminated. 

8. In cycle 16 and earlier* the user.prolog and user.epiiog entries 
for validated users contain the following* 

user.prolog* 1 include.fi ie Ssystem.pro logs.and.epl logs.user.prolog 1 
user.epi log*' I nclude.fi ie Ssystem.pro logs.and.epl logs. user.epi log* 

In cycle 17 ^nd later* the user.prolog and user.epi log entries 
must now contain the foil owing? 

user.prolog * f Suser.prol og* 
user.epi log * * Suser »ep! 1 ©§ f 

Users validated in cycles below 17 must have the entries changed 
to the above mentioned information by the Family Administrator. 

The VALIOATE.USER procedure has been modified to accomodate the 
change. Those users created using this procedure in cycle 17 or 
later will have the correct Information for the user.prolog and 
user.epi log entries. 
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There has been a change to the type of value supplied as parameter 
to the SET.USER.PRQLQG and SET.USER.EPILOG subcommands of 
ADNINISTERJJSER. The change Is as follows* 

set. user .pro log prolog* f <f I le.ref erence> f 
set.user.epl fog epl lpg»*<f I le_ref erenceX* 

9. Recall from the Installation and Upgrade manual that to advance to 
a new NOS/VE system and have the NOS/VE permanent file base 
Intact/ It Is necessary to install the system and recovery job 
template from the new system using the old system. After the 
templates have been Installed* the terminate.system command Is 
used to bring the system down. Recall also that as soon as the 
system has terminated* another deadstart of NOS/VE (recovery 
deadstart) occurs automat lea My . It Is essential that this 
recovery deadstart be allowed to completed for the old system 
because this recovery deadstart Is the checkpoint of the 
previously running system (I.e.* permanent files are updated to be 
consistent with memory contents at termination and deadstart 
termination status is recorded). 

An experienced installation analyst may realize that if the 
recovery deadstart following termination is not allowed to 
complete* a recovery deadstart will be automatically initiated 
when the next continuation deadstart Is attempted. If the 
recovery deadstart following termination for the old system Is not 
allowed to complete* the new system (cycle 18) will be unable to 
deadstart and the old system will h^v^ to be deadstarted to allow 
recovery to properly complete. 

1. NOS/VE will not support more than 10 tasks concurrently defined 

P^t job. The system does not enforce this limit* users must be 

careful not to exceed ttiis limit or they may cause the system to 
fail. 

3.3 oEiE&iiiE-fcoitiiiias 

1. Restarting IRHF and IFEXC on the 180 Side 

IRHF should automatically restart if it aborts. There is a 
constant check to see if it has aborted. To bring %ip IRHF 
manually* the operator must first bring down IRHF# then bring it 
up again. The same holds true for IF EXEC. 
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To bring down IRHF* type in it the 180 NOS/VE operator *s consoles 

K.DEACTIVATE/0SYSTEH/OTASKS TA$K/ONAM£$*RHINPUT 
K.DEACTXVATE/OSYSTEM/OTASKS TASK/0NAHE5«RHGUTPUT 

Then to bring IRHF back upt type In it the 180 NOS/VE operators 
consoles 

fUACTIVATE/OSYSTEM/OTASKS TASK/ONAMSS»RHINPUT 
K.ACTIVATE/OSYSTEN/0TASK5 TASK/ONAMES»RHQUTPUT 

To bring down IFEXEC* type In at the 180 NOS/VE operator's 
consoles 

K.DEACTIVATE/OSYSTEN/OTASKS TASK/GNAMES*IFEXEC 

Then to bring IFEXC back up# type In at the 180 NOS/VE operators 
console: 

K.ACTIVATe/OSYSTEH/OTASKS TA$K/GMAHE»IFEXEC 

PSR NV00032- 

2* Restarting IRHF and PASSON ^n the 170 Side 

To make provisions for restarting IRHF and PASSON* a site analyst 
or an operator should create two procedures and s^e each one on 
an Indirect permanent file that is located under user index 
3777T7S. 

Procedure ■ !• The file name should be HSSIRHF and should look like 
this: 

.PROC*HSSIRHF» 

COHHON* SYSTEM, 

STR*SYST£!1#NVELIB*U*ULI8/NVELI8 

UNLOAD* SYSTEM 

LI8RARY*N¥ELI8. 

RUNJ08SCIRHF) 

Procedure 2* The file natie should be HSSPASS and should look like 
this: 

♦PRGCjHSSPASS, 

€0HN0N*$Y$T£9i« 

STR*SYSTEH*NVELIB*U*ULIB/NV£LIB 

LI8RARY*NVELI8. 

RUNJG8SCPASS0N) 

Once these are In user index 377777B»' IRHF is restarted by simply 
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typing the following In at the 170 operator's console: 

HSSIRHF, 
PASSON Is restarted by typing Jn at the 170 operator's console* 

NSSPASS. 

PSR NY00016 and PSR NVQE293 

3. The NOS application CVEIAF) that connects NOS/VE jobs to NAN will 
sometimes produce the flashing console message* 

"PASSON ABNORMAL 18" 

This message mains PASSON is discarding an unsolicited message 
generated between VEIAF and the first read request from NOS/VE* 

This should be ignored* Clear the message with v G0#Jsn* 9 
3.4 CaHIISMAIIOH-HABASIMMX 

1* The INITIALIZE.DEADSTART.DEVICE system-core command and the 

INITIALIZE.NS.VOLUHE Logical Configuration Utility subcommand do 

not warn the operator that the volume hms been previously 

initialized* This is of particular concern In 

INITIALIZE.NS.VOLUHE because the operator may misspell the 

element.name of the device and inadvertently destroy permanent 
files* 

2. If the physical configuration consists of one channel* one mass 
storage controller* and one mass storage unit* one can describe 
this initially using system-core commands* However * this 
configuration needs to be redescrlbed using Physical Configuration 
Utility and Logical Configuration Utility subcommands in order to 
get through an installation deadstart* 

3* For optimal system performance all NOS/VE disk units should be 
defined during the install deadstart* This is important so that 
all of the logical configuration Is available for allocating 
product set f i les* 

4* During recovery when operator intervention has been specified* the 
logical configuration utility <LCU) Is invoked both before and 
after the configuration transition. The first invocation allows 
the operator to change which elements In the physical 
configuration are logically configured* The second invocation 
allows the operator to Initialize and add volumes to the system 
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3.4 CONFIGURATION MANAGEMENT 

set. This is useful if the first invocation of the LCU happens to 
add one or more volumes to the logical configuration. 

5. The ability to invoke the LCU during a continuation deads tart as 
described In the previous bullet has been added* 

6. The physical configuration utility subcommand* 
INSTALL.PHYSICAL.CONFIGURATION has a new parameter, 
PHYSICAL^CONFIGURATION. This parameter specifies the name of a 
local file that will receive information about the physical 
configuration being debugged. Use of this parameter Mill cause 
the configuration to NOT be Installed. The file produced by this 
command can be used as input to the INSTALL_LOGICAL_CONFIGURATIGN 
subcommand of the logical configuration utility. The abbreviation 
for PHYSICALJTQNFIGURATION Is PC. 

?. The logical configuration utility subcommand* 
INSTALL.LOGICAL.COMFIGURATION has a new parameter. 
PHYSICAL_CONFIGURATIOH. This parameter specifies the name of a 
local file that will provide information about the physical 
configuration being debugged. Use of this parameter Mill cause 
the configuration to NOT be installed. The abbreviation for 
PHYSICAL.CONFIGURATION Is PC 

8. A new keyword has been added to the command table for the 
S£T_$YSTEM_ATTRIBUTES command, $USP£NDED_JOB_TIMEOUT_LIMIT. It 
provides the capability to change the timeout limit for detactied 
interactive jobs via the SETSA command by entering* 

SET_$YSTEM_ATTRI8UTES N»SU$PEND£u_J08_Ti?1E0UT_LIMIT V«nnnnnnn 

where nnnnnnn represents milliseconds and has a valid range of 

hOOQOQ - immm® 110 minutes —3 hours I* 

NV0E528 

3.5 DEVICE J!A!iAfi£!!£!IIZa££flttE3C 

1. If any disk volume being used by NOS/VE becomes full* the 
following message will periodically %pp%bt on the MOD screen* 

AAAAAA — volume out of space 
<AAAAAA is the van of the volume) 

Any task that is requesting space on a full volume will hang 
waiting for space. Some space may be obtained by asking users Cif 
they are able) to delete permanent files %t\4 detach local files. 
If the disk full condition persists* the NOS/VE system should be 
taken down and brought back up* This action will release most of 
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the temporary file space that Has In use* If the disk full Mas 
caused by permanent files* then the disk nil I be nearly full after 
the recovery* and some action — such as backing up permanent files 
and deleting some files— must be taken Immediately* 

It Is possible that a disk full situation will occur that cannot 

be recovered* This will have happened If the "volume out of 

space* message appears during a deals tart before the system is up* 

In this case case permanent file volumes must be Initialized and 
reloaded from a previous backup dump* 

2« If a continuation deadstart falls after disk full with a 180 CPU 
monitor fault* It Is possible that the failure is due to unprinted 
files in the output queue* one or more of which are no longer 
printable* The failure is a Job mode software failure and does 
not leave the H€R set in monitor mode* The message indicating 
this failure is »HR - NONITOR FAULT*. 

Corrective actions 

On the next attempt at a continuation deadstart* enter the 
following command when the system asks for operator supplied core 
commands * 

SET.SYSTEH.ATTRIBUTE HALTRING 

This command wilt allow deadstart to complete* If* at this time* 
you find that task RHOUTPUT has ternlnated (by looking at the 
system job log by doing a DIS3D* and files exist in the Job 
output queue ( DISPLAYS ATALOG $SYSTEH*$J08^0UTPUT.QUEUE) you can 
be reasonably sure that you have encountered this problem* 

Delete the contents of the job output queue (DELETE 
CATALOG.CONTENTS $SYSTEH.$J08_0tlTPUT_ QUEUE)* terminate NOS/VE* and 
do another continuation deadstart* 

3* When recovering without a memory image* the EGI for a file Is set 
to the highest allocation-unit which has been Initialized on the 
device* This is probably not what the actual en d-of- information 
(EGII shows in the memory image* The file's owner Is not informed 
that a different £01 has been chosen. This means that the user 
cannot use 8AH to read the file* The file needs to be recreated* 
PSR NV0E524 

1* When using X25 to access NOS/VE* a terminal may Intermittently 
hang allowing no input or output* TIP commands break (such as 
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escape-CH) out of this problem* This is a CCP problem that has 
been PSRd and corrected in CCP. 
PSR CC5AE30 

3.7 e£&MaEttI-£IL£_UIILIIIES 

1. There is a timing problem/data sensitive bug that may 
occass lonai ly cause the RESTORE_P£RNANENT_FILE command to abort. 
If this occurs* the operator should restart RESTORE with the 
falling reel. If the problem does not re-occur* only one file is 
lost. If the problem still occurs* restart RESTORE again but with 
the real that follows the failing reel. In the second case* all 
files on the tape following the point where the failure occurred 
are lost. 
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4.0 Q££Emii£_SX$I£fl-m£S.48fi-£AyiIDSS 



4.1 mi£&_£IU!Miii2_U*iJ2ii*££ 

1. A command that depends on the ♦'path naae* for a file is affected 
if the file lias been explicitly attached lattach.fi ie# create.fi le 
commands). 

The "path name** that such a command will encounter is the "local 
path name" rather than the path specified when the command Mas 
called. For examples 

ATTACH_FIL£ SUSER.X LFN«Y 
REPLA€E_FILE SUSER.X 

Mill result in a file called Y being referenced in real state 
rather than X. Users should not mix implicit and explicit 
attaching of a file. 
PSR NV0D753 

2. The SPROGRAM function does not return the open position designator 
for the LOAD.HAP file. 

PSf? NV0D483 

3. The SET.SENSE.SWITCH CSETSS) command will not accept a "user 
supplied job name" but Mill only worfc when given a "system 
supplied job name**. 

PSR NV0D871# PSR NV0D388 

4. The constants $HIN_INTEGER and $HAX_INT£G£R have values of 
-{2**48-11 and 2**48-1* respect Ively* rather than ~<2**63l and 
2**63-1. 

PSt HV0D609 

5. A new dlspi ay.opt Ion has b%et) added to the displ ay_catatog and 
displ ay_catalog_antry commands. For the former command this 
display option Is called CONTENT(S) or Cl an4 for the latter 
command it is called CYCLECS) or C. Also* a parameter called 
DEPTH has been added (following the output) parameter) to both 
commands that works In conjunction with the added display options. 
These options shoir the amount of space occupied by catalogs* 
files* and cycles* The depth parameter determines the level of 
detail that is displayed. 

0EPTH*1 gives a 1 line summary of the catalog Cor file). DEPTH»2 
Cthe default) gives a breakdown of files and subcatalogs contained 
directly In a catalog lor the cycles of a file). A DEPTH greater 
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than 2 is only applicable to catalogs and specifies a further 
breakdown of the catalogs and files contained within the 
subcatalogs of the catalog* To get complete information about ail 
subcatalogs* files and cycles contained In a catalog* specify 

D£PTH*ALL* These changes did not make it into the manuals* 

6. The ACCEPT_LINE command now has an optional LINE_CGUNT CLC) 
parameter which can be used to specify an SCL integer variable to 
receive a count of the lines read by the command* 

The $FILE function now supports the GL0BAL_FILE_PG5ITIQN CGFP) 
attribute* The values for this attribute 9tb described under the 
DISPLAY_FILE_ATTRI8UT£S command* A GLOBAL.FILE..POSITIGN attribute 
value is returned by the function as a string with all letters In 
upper case* 

These facilities can be used to detect EOl rEnd-Qf-Informat Ion) 
when reading a file by means of the ACCEPT.LXNE command* 

7. Any files created by the program interface cannot be displayed 
with DISC SLOCAL* For example* the default flies created in 
FORTRAN do not appear when subsequently entering DISC $L0CAL* 
PSRs NVEA052* NVEA095* NVEA056 

8* JQ8/J08END does not work properly when it encloses commands or 
text containing semicolons* All semicolons appearing at 
end-of-tine are wrongly deleted! embedded semicolons are retained 
however* This problem means that J0B/408EN0 cannot be used* for 
example* to compile a CYBIL program* because the source code 
(assumed to be within a COLLECT.TEXT) mill have its semicolon 
delimiters stripped away! the compiler then issues hundreds of 
error messages* Use LOGIN/LOGOUT to avoid the problem* 
PSR NV0F060 

4.1*1 ADDITIONAL COHNANDS <N0T IN MANUALS) 

4.1.1.1 ais£LAX-aaai4iiii-£Aa4a£i£EiSi.iaiii:£i 

This command displays Information about the parameters for a command* 
The Information includes the names of the parameters* their types 
(including allowed keyword values) and their default values lor an 
Indication that the parameter is required)* 

This command is not intended to be a replacement for information In 
on-line manuals* but rather a "memory jogger" for any command. It will 
work for any command that could be called at the point where this 
command is called C including system supplied commands* SCL procedures* 
user programs and utility subcommands)* 
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This command can be used to obtain information about the parameters 
for any command that uses SCL services to parse its parameters* 

displ ay..cofflniand_parametars command*<command> 
Coutput«<f I ie refer ence>l 
£status*<status var iable>3 

command J c* This parameter specifies the command for which information 
about parameters is sought* 

output 1 os This parameter specifies the file to which the parameter 
information is written. Omission Mill cause SOUTPUT to be used* 

status* This Is the standard status parameter* 

4.1.2 ADDITIONAL FUNCTIONS CNOT IN NANUALS) 

4.1.2.1 $£0I1M&U1„£QUR££ 

This function is used to determine where the processor for the 
requesting command wis found. The source (file or catalog} of the 
command is returned as a string. 

By Its nature* this function Isn't particularly useful when used In 

the expression for a parameter to a command* since* in that case* it 

ail! return the source of that command. Therefore* this function Is 
normally used in an assignment statement, 

<$comiiand_source> u« SCOHHAND.SQURCE C<<> <}>3 

Example* "The following proc resides on an" 
"object library in some catalog, *• 
PROC sample_command 

cs * $command_source 

cat * SpathCSf nameCcs)* catalog) 

execute_task Sfnamel cat// 1 .sampl a_progr am) 
PROC END 

4.1.2.2 i£E£Jttmj£-3I4iy$ 

This function is used to obtain the completion status of the previous 

command, 

<$previous.status> n> $PR£\riQUS.STATUS £<f> <)>! 

Examples col lect_taxt display_status 

PROC dlspl ay_status# diss ( 

status: status « Sprewi ©us ..status) 
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displ ay_yalue $va!ue( status) 
PROCEND displ ay.status 

** 

create_var table s Mnd«status 
create_variabla x statuses 
displ ay_status 
NORMAL STATUS 

create. variable x statuses 
displ ay_status 
—ERROR-- X Is already declared as a variable* 

4.1.2.3 IfiliOIi 

This function is used to quote a string. 

<$quote> «** SQUOTE <l> <string e%pr> <)> 

Example* s - *A&C VV DEF' 
1* » $<juote(s) 
displ ay_vaiue s 
A8C f D£F 

display.value q 
•ABC^OEF 1 

4.1.2.4 IS£Ai-4aX 

This function is used to search a string for any one of a set of 
characters and return the index In the string of the found character. 
If no character fro« the set appears In the string* zero is returned. 

<$scan_any> n» $SCAN_ANY <(> <char set> <»!sp> 

Cstrlng %xpr> <)> 

<char set> **» < string Bxpr> 

Example* digits * •0123456789* 
s - •TEHP.32* 
d i sp lay_v a I ue $scan_anyC digits* s) 



4.1.2.5 i££M-Mi2I4MI 

This function Is used to search a string for any character that is 
not In a set of characters and return the index in the string of the 
found character. If only characters from the set mppbbt in the string* 
zero Is returned. 
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<$scan_notany> ti« SSCAN..NOTANY <<> <char set> <*5sp> 

<string expr> <)> 

<char set> **» Cstring expr> 

Example* digits » '0123456789* 
s » •TEMP^Z' 
dlsplay_value $scan_notanyt digits* s) 

1 

4.1.2.6 i$CAH_miHfi 

This function is used to search a string for another string* called 
the pattern* and return the index of the first character of the pattern 
In the string. If the pattern Is the null string* one Is returned. If 
the pattern is not found in the string* zero Is returned* 

<$scan_string> **» $SCAN_STRING <(> <pattern> <*5sp> 

Cstring txpr> <)> 

<pattern> **« <string expr> 

Example J s « , 123_abc_9 t 
P * 'abc 1 

displ ay_vaiue Sscan.str ingCp* s) 
5 

4.1.3.7 IIMMSLAJE 

This function is used to change characters in a string according to a 
translation table. The translation table is a string of 256 characters 
which Is utilized according to the following algorithm. 

result * * • 

for I * 1 to Sstri en (string) do 

j * $ord<$substrCstr Ing* H) 

result « result // Ssubstr Itable* j+1) 
for end 

Two standard translation tables are provided. Use of LOW£R_TG_UPPER 
<LTU) produces a string with all loner case letters translated to their 
upper case counterparts. Use of UPPER_TtL,LGyER CUTt) produces a string 
with all upper case letters translated to their lower case counterparts* 

<$translate> *»» STRANSLATE <<> translation table> <>\$p> 

Cstrlng expr> <)> 

<translation tabla> ss* <string expr> 
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4.1.2.7 $TRANSLATE 



Examples 



display.value 
123.A8C 



LOMER^TO^ UPPER 



J UPPER_TO, 



.LOWER I 



LTU 
UTL 



ransiateMower_to..upper* f 123_abc* ) 



4.1.2.8 Il&Ifil 

This function is used to remove trailing space characters from a 
string. 

<$trini> :*» $TRIH <i> <string %xpr> <)> 

Example* s * 'STRING * 

displ ay_value , < , //s// , > i 

<STRING> 

display_value «<* //$tr im<s)//«>* 

<STRING> 



4,1.3 ADDITIONAL CONTROL STATEHENTS (NOT IN MANUALS) 
4.1.3.1 £USH-£01SMMS 



<push co*»mands> *:* PUSH^CGMNANDS 

The purpose of this statement is 
catalog} of the Issuing command to be 
"dynamic command list*** The entries 
searched after the commands belonging to 
the command list entries . manipulated 



The effect of this 
command terminates. 



to cause the source If He or 

pushed onto the top of the 

in the dynamic command list are 

any active utilities and before 

fey the SET_COMMAND_LIST command. 

statement is removed (popped) when the issuing 



4.2 ££gMM£i*IJEIL£S 

1. The DISPLAY_CATALOG and DISPLAY_CATALQG_£NTRY commands* when used 
on a catalog or file owned by another user* should only provide 
information for catalogs and/or files that the requesting user is 
permitted to access. This restriction is not enforced. The 
information erroneously provided* however* does not Include 
passwords and only contains log entries and permit entries that 
apply to the requesting user. 
NV0E251 
NV08133 
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4.3 E£aai£.HQSi 

1* When the NOS/170 IRHF is started via a DIS job Cfor debugging 
IRHF)* it does not transmit queue files to NOS/VE. RUNJOBS is 
unable to acquire the queue file from NGS/170. See Section 3*3 of 
the SR8 for a method of restarting IRHF. 

1* When a bad LOGIN command is present in a batch job* the job 
d\s%pp^^rs and printout with the error is received by the user to 
report the problem. This occurs when sending a job from NOS to 
NOS/VE via ROUTE* xx*DC*LP* FC-RH. 
NV0E491 

2. Changing passwords on NOS and H05/VE. 

In NOS 2.2* there are two passwords for each user. One is the NOS 
interactive job password and the other is the NOS batch job 
password. The NOS interactive job password is used while working 
on a terminal. It is also used for NOS/VE login processing * when 
logging into NOS/VE on an interactive terminal* there is no check 
made of the NOS/VE password for validation purposes* just the NOS 
Interactive job password. Changing your NOS/VE will affect only 
your NOS batch password. Your NOS/VE password must match your NOS 
batch password otherwise Remote Host will not work since it 
submits batch jobs to NOS. 

Note i «hen using the SET_iINK_ATTRI8UT£S command, the NOS/VE 
password specified must match the NOS batch job password. 

Note * The selection of passwords for NOS and NOS/VE must conform 
to the definition as given in the NOS Reference Manual for the NOS 
password and the NOS/VE Command Interface Reference Nanual for the 
NOS/VE password. You have to take the common parts of both 
definitions to make a password that works for both NOS and NOS/VE. 

To change your NOS/VE password* enter the S£T_PASSWORD command on 
the 180 side * 

Setpw oldpw newpw 

where oldpw Is your current NOS/VE password and newpw is the new 
password. 

To change your NOS batch job password* you will have to submit a 
NOS batch job. Login to the 170 side and create a file to submit 
this job. the file should contain the following* 

J08CAR0. 

USER ( us er n am, user pw ) 
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CHARGE** 

PASSWORD (user pw* new pw) 

END 

where usernam is your username* userpw is your current NOS batch 
password* and newpw is your new NOS batch password* Your original 
NOS batch password is set to your original NOS interactive job 
passwords. All of the above commands in the file created must be 
typed in capital letters. 

To submit this job* type in t 

submit* lfn*b* 

where Ifn is the file you created. 

In order to change your NOS interactive job password* type In on 
the 170 side * 

passwor*oldpw*newpw. 

where oldpw Is your current NOS Interactive p%ssmor<i and newpw Is 
your new interactive job password* 

4*4 ££0£EAJLJAM4££f3£ai 

1* Loading files into multiple rings may cause improper ring 
attributes to be assigned* 
PSR NV0C789 

2. The file position specifier is Ignored when mentioned on SETPA. 
For example* specifying SETPA DEBUGJ3UTPUT* $LIST*$£0I will cause 
debug to overwrite the SLIST file from its SOI position (not EOI 
as expected). 
PSR NVEA036 

4.5 2mXCAL-lZILlIA££i 

1* Tapes are generally available for use in a single or multi-volume* 
unlabel I ad file environment* Copy file of multiple files to a 
single tape produces undefined results* however. 
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4.6 aAsic.AS^£SS-i3£iaflfi 

1* The SET_yORKING_CA?ALOG CSETwT) command has no effect upon files 
whose names are created within applications* For example: 

SETWC ajl 
execute M task 

task generates file name a 

The path naie of the file Is not *ajl*a; It Is Sicca I* a* Only 
actual parameters of a command are subject to SETWC direction* 
PSR NVEA027 

2* The preset.value file attribute Is not supported* 
PSR NV08204 

3* File attribute HIN^RECOROJ-ENGTH Is not set properly for 
record^typa F files* HIN_R£CQRD_L£NGTH should be set to 
«,AX_RECORD_LENGTH If It Is allowed to default* but it is currently 
defaulting to 0* This affects SORT/HERGE when the sort key Is 
omitted and the default is taken* 
PSR NV0D398 

4* If »ore than 100 Instances of OPEN exist concurrently within a 
single task* an ame$local_f I le_t imlt message is issued* The 
message indicates erroneously that 152025 local files Is the limit 
which was exceeded* The massage should say that only 100 
Instances of open way exist concurrently In a task* 
PSR NV00856 
PSR NV0D632 

5* Skipping forward/backward by records and partitions does not 
always report the encounter with boundary conditions with the 
correct exception condition* 
PSR NVOE044 
PSR NV00424 

ft* If a FAP returns abnormal status to AHP$0PEN during an OPEN (new I* 
the file name Is still registered within the job and Implicitly 
created permanent files are not purged* Recommend explicitly 
purging the permanent file. 
PSR NV0E150 

?♦ CQPYJFILl: does not work on Index_sequential files when executed 
from a task* 
PSR NV0E588 

8* File attributes that can be changed cannot be reassigned a NIL 
value* 
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PSR NVEA003 

9. DETACH_FILE returns FATAL abnormal status when a file Is not known 

and causes a batch Job to terminate. Use of the STATUS parameter 

to ignore the error Is recommended. 
PSR NV00618 

10. The SET^FILE^ATTRIBUTE command for an existing file accepts the 
specification of a preserved attribute even if it conflicts with 
the present one. No error will be seen and the preserved 
attribute Hill not be changed. 

P$R NV0C839 
PSR NV0D617 
PSR NV0DS49 
PSR NV0D536 
PSR NVEA036 

11. When processing a COBOL READ REVERSE statement* BAH\ falls to set 
the file position to 801 and as a result the COBOL statement nil I 
loop Indefinitely. 

PSR NV0E044 

12. C0PY_FILE does not detect a copy to itself via circular fiie 
connections. 

PSR NV0E286 

13. Aiap$put_part lal# with terra_optlon ■ amc$terminate# at 
f I ie.posltion 801* gives 'unreoovered write error 1 on a new file. 
Recommend using amp$put_part!al» with term_option * amcSstart. 
PSR NV0D666 

14. Flies implicitly attached are not Implicitly detached. 
PSR NV0E322 

PSR NV0E296 

15. The CONTAXHS_DATA flag delivered by AHP$GETJFIL£_ATTRI8UTES is 
incorrect for a newly created Index sequential file. This 
prevents AAH from working properly when multiple simultaneous 
OPENs are issued on a file. The werfc around Is to CLOSE and 
re-QPEN the file immediately after doing the first OPEN/ NEW. 

PSR NV0E901 

16. An intermittant range error occurs if BAN$SYS_8LK_VARIABL£_REC_FAP 
during a C0PY_FILE command. 

PSR NV00706 

IT. Attributes in the MOS/VE file label cannot be altered after 
creation. This could affect some migrating applications using 
indexed sequential files because FILE.LXHIT could be updated on 
C170 but not on CIS©. 
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PSR NVEA034 

18. The file position specifier on a MERGE directive in the SQRT.MERGE 
directive file isn't ignored* 

PSR NV0E415 

19. In the DISPLAYJ=ILE_ATTRIBUTE printout* GPEN.PQSITIGN. 
HeSSAGE.CQNTROL* end ERROR_LI*UT do not reflect the values 
supplied by a previous AHPSFILE call* 

PSR NV0E515 

20. The attribute array given to ANP$FETCH_ACC£SS..INFGRMATIQN Mill not 
currently allow AflCfNULL.ATTRIBUTE. 

PSR NV0E716 

4.7 LOAHES 

1* If a task adds a library to the job's object library list dynamic 
loads within that task will be unable to satisfy externals from 
the newly added library. This especially affects the usability of 
commands packaged In the job monitor task because libraries added 
to the object library list by the system prolog cannot be used to 
satisfy externals of these commands* 
PSR NV0E175 

Z. The default for the program attribute LOAD_HAP.QPTION is set to 
NONE. This means a load map will not be generated by EXECUTE_TASK 
unless the LOAD_NAP_OPTI0N parameter has been previously specified 
by a S£T_PR0GRA8_ ATTRIBUTE command or explicitly specified on the 
EXECUTE.TASK command. 

3. The length of large data segments and files cannot exceed 

100*000*000 bytes. 

4. A job which attempts to use COPY.FILE on an indexed sequential 
file will abort with an error "unable to find FAP 
AflPSADVANCED.ACCESS.HETHOOS*. 

PSR NV0C941 

4.6 mmuQiiig 

1* If a user's terminal should become disconnected from NOS/VE* the 
job can be resumed b$ logging in to the system and entering the 
command ATTACH^JQS IATTJ). The terminal will be reconnected to 
the job; and the job will be put into a pause break state. The 
TERHINATE.COHNAND and R£SUHE_C0*1MAND commands can be used at this 

- COMPANY PRIVATE - 



4-12 
SOFTWARE RELEASE BULLETIN 

84/03/12 
NOS/VE (CYCLE 18) 

4.0 OPERATING SYSTEH NOTES AND CAUTIONS 
4.8 INTERACTIVE 



time tilth the same results as during a pause break. A DETACH_JGB 
COETJI command lias also been added to allow a user to detach a Job 
bf command. The DISPLAY_J08_STATUS command will display 
disconnected and detached jobs. Detached jobs Mill be terminated 
after a system defined time has elapsed. 

2. In order to use a CDC ?21 terminal on NOS/VE* the following 
command should be entered: 

SET_TERHINAL_ATTRI8UTES TC-T401C 

3* Access to NOS/VE (VEIAF) via X25 connection will cause the 
terminal land its NOS/VE Job) to hang. The hang state can be 
cleared by entering any TIP command* such as escape-CH. Code to 
fix the problem in CCP is available and is associated with PS9 
number CC5A230. 

4. NOS/VE Rl.0.2 does not support an END-OF-INFORMATION CEOI) 
facility for indicating to an Interactive program that the user 
wishes to terminate interactive input of data. The input must be 
ended by a count or by detection of a particular input value. 

PSR NV0E484 

5. If an interactive job is using a display type terminal CCRT) and 
the page width terminal attribute Is not set to exactly the page 
width of the terminal* then overprinting of some lines will occur. 
To remedy this either set the page width correctly for the 
particular terminal or set the output.devlce attribute to printer. 

*.9 4QS-Mii4££ti£SiX 

If the job reaches time limit* the WHEN clause is repeatedly 
activated with normal status. If the when contains a CONTINUE* then 
processing continues in an endless loop. 
PSR NV0E368 

4.1C IHI£iSI4I£.a0iHUtlIClAII0M 

Changing passwords on NOS and NOS/VE 

For NOS 2.2* your NOS batch password has to match your NOS/VE 
password otherwise Interstate Communications Mill not work since it 
submits batch jobs to NQS. Refer to Section 4.3 of the SR8 on how to 
change your passwords. 
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4.0 OPERATING SYSTEM NOTES AND CAUTIONS 
4.11 DISPLAY_8INARY_LQG 

4.11 m£LAXJ&JMRX~LI2£ 

4.11.1 OISPLAY..BINARY_LOG 

DISPLAY_8INARY.LOG is a command utility that processes the contents 
of the global binary logs C statistics* accounting and engineering) Into 
human- readable reports and graphs. There are no pre-packaged reports 
built into 0I$PLAY_BINARY_LOGj instead* user sub-commands specify the 
statistics to be extracted from the log and the types of analysis to be 
performed. Input to the program may be either an active system log* or 
a permanent file copy of a log as produced by the Terminate_Log command. 
The Information to fee extracted from the log* and the type and format of 
the reports produced* is specified by sub-commands supplied by the user. 

4 . il.i . i lim„jUm£X.MM£l_LO£_£J2]Siac4 

PDT dlsbl_pdt ( 

input* i* LIST OF FILE 

type* t* KEY statistic* statistics* account*. •• 

accounting* engineering » statistic 
output* 5 FILE * SGUTPUT 
status ) 

This command* which may be abbri aviated DIS8L* enters the user into 
the command utility environment. Subsequent sub-commands will be 
prompted for by the string **DIS8L/*. 

The binary log to be processed may be either a currently-active 
system log* or a copy of a terminated log. If an active log Is to be 
used* the TYPE parameter specifies the desired system global log* and 
the .INPUT parameter is omitted. If a terminated log is to be used* the 
INPUT parameter specifies the file name* and the TYPE parameter is 
omitted. If a list of file names Is provided for the INPUT parameter* 
the data *HI be processed ns If the contents of these files are 
concatenated in the order that the files are specified. 

The OUTPUT parameter specifies the file on which the reports 
generated by DISPLAY_BINARY_LOG %t^ written. All current reports are 
formatted for a page width of 132 columns. 

The first output page generated by DISPLAY. 8INARY_LGG lists the input 
files processed and the beginning and ending dates and times for each 
file. 
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4* 11*1 .2 Definition Sub-Commands 

4.11.1.2 Q$£iai£iaa^y & = £flffij3Ands 

The user extracts data from the binary log by first specifying one or 
wore groups of statistics* and then specifying one or more metrics 
(numbers expressing a measurement) to be derived from each group* For 
example* one group might consist of the end-of-job statistic for each 
Job run on the system* and an associated metric might be the CP time 
consumed for each job* 

Final reports are generated through the use of a set of DISPLAY sub- 
commands* The particular DISPLAY sub-command used specifies the form of 
the report (histogram* statistical summary* etc*)* and parameters to the 
sub- command specify the metric or metrics to be displayed* and 
additional information about the form of the report* 

To economize on execution time* DISPLAY_BINARY_LGG processes all sub- 
commands* up to the QUIT sub-command* before generating any reports* 
The binary log n^%4 be scanned only once* and all reports are generated 
in parallel* They appear on the final output file* however* in the 
order in which their sub-commands were issued* 

As each group and metric is defined* it is given a user-chosen name* 
which is subsequently used to refer to It* These names may be up to 31 
characters in length* and follow the usual SCL conventions for names* 
The group or metric identified by a given name need not be defined 
before the name Is useiif but must be defined before the QUIT sub-command 
that terminates the sub-command set* 

4.11.1. 2.1 THE D£FINE_GROUP SU8-C0MHAND 

PDT def g_pdt ( 

groupjgs NAHE « SREQUIRED 
statistic* si NAME 
time* t* RANGE OF time^value 
date* d* RANGE OF date.vatue 
Job. predecessor* jpi NAHE 
tasfc_predecessor* tp* NAME 
descrlptlve.dat a* 46* STRING 
between* b* LIST 2 OF NAHE 
) 

This sub-command defines a statistic group* The GROUP parameter 
supplies a name for this group* and is required* The other parameters 
»r^ all optional* and specify conditions which each statistic must 
satisfy before it will be part of the group* If two or more conditions 
are specified* a statistic must satisfy all conditions specified before 
It will be included in the group* 
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4,0 OPERATING SYSTEM NOTES AND CAUTIONS 
4*11*1*2*1 THE DEFINE.GROUP SUB-CGHNAND 



The STATISTIC parameter specifies a statistic Identifier. Statistic 
Identifiers are of the form AANNNNN* where AA is two alphabetic 
characters* and NNNNN is a decimal number* For example* AV260007 is a 
statistic emitted by the accounting and vai idation code at and-of-job* 

The TIHE and DATE parameters can be used to iifnit the time period 
within which statistics will be recognized* The default range of time 
Is from 00*00*00 to 23*59*59* The default range of date is from 
00/01/01 to 12/31/99* If only one value is specified for a parameter* 
instead of a range* then the provided value Mill be taken as the loner 
limit of the ran®&» and the default used for the upper limit* 

The DESCRIPTIVE.DAT A parameter supplies a string which is matched 
against the contents of the descriptive data field in each statistic* 
Matching is performed character-by-character to the end of the parameter 
string* If the descriptive data field In the statistic is longer than 
the parameter string* the excess characters are ignored* 

The TA5K.PREDECESSGR parameter is used In combination with other 
parameters on the DEFINE. GROUP sub-command to relate two or more 
statistics Issued by the same task* The TASK.PREDECESSGR condition is 
satisfied if the task issuing the statistic also previously issued 
another statistic* which is a member of the group specified for the 
TASK.PREPECESSOR parameter. 

For example* 

Defl ne.gr oup compl le.tasks statistic » PH2300C2* *• 

descriptive.data » f FCP$CONPILE_FGRTRAN_$OURCE» 
Define.group compi le_end.of.task statistic « PH2300O3* •• 

task.predecessor * compl le.tasks t*O8s0O« 00**16*00*00* *• 

d«01/01/83. ,01/01/83 

These commands define a group called comp i I e.end.of.task that contains 
the 0n4 of task statistics for all FORTRAN compilation tasks* 

The J08.PREDECESS0R parameter Is used In combination with other 
parameters on the DEFINE. GROUP sub-command to relate two or more 
statistics issued by the same job* The JOB.PREDECESSGR condition Is 
satisfied if the job issuing the statistic also previously issued 
another statistic* which Is a member of the group specified for the 
J08.PREDECESS0R parameter* 

The BETWEEN parameter is a future feature* It is currently accepted* 
but Ignored* 

4.11.1.2*2 DEFINE.HETRIC SUB-CQHHAND 
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4.0 OPERATING SYSTEM NOTES AND CAUTIONS 
4. 11. 1.2. 2 DEFINE.METRIC SUB-COHHAND 

POT defm_pdt ( 

metric* mi NAHE » SREOUIREO 
groups g* NAHE - SREQUIRED 
seal e_f actor* sfs INTEGER 
unit* ut STRING 
counter* c* INTEGER 1..63 
expression* e* STRING 
I 

This sub-command defines a metric. The METRIC parameter specifies a 
name for this metric* and is required* The GROUP parameter is also 
required* and specifies the group from whose members this metric is to 
be derived* 

The SCALE.FACTOR parameter is used to adjust the values of the 
resulting metric in order to make then; easier to understand or use* 
Each metric element Is divided by SCALE.FACTOR before being used to 
generate reports. IF this parameter is not specified on the 
DEFINE_H£TRIC sub-command* a value of 1 Is used for the scale factor. 

UNIT is an optional parameter that can be used to provide a string 
identifying the measurement unit associated Kith the values of this 
metric* If a unit is supplied* It Is used to label that metric In all 
output reports* If the UNIT parameter is not used* it defaults to 
bl anfes* 

The other parameters specify different ways In which a metric can be 
derived from the members of the group* One and only one of these 
parameters can be used In a given DEFINE_METRIC sub-command* 

COUNTER specifies the Index of one of the 63 possible counters 
Included in a statistic. The contents of the specified counter for each 
statistic in the group make up the resulting metric. 

EXPRESSION specifies m arithmetic expression that is evaluated to 
yield the value of each metric element. At present* the only expression 
that Is accepted by DISPLAY_8INARY_LGG Is 'l 1 . This expression Is used 

to count the number of elements in a metric. 

4. 11* 1*3 Oj^El££_5u&r£a®iiA£y3s 

This group of commands is used to specify reports to be written to 
the output file* As noted above* all commands are processed* up to the 
QUIT command* before any reports are actually generated* The reports 
appear on the final output file in the order in which their sub-commands 
Mere Issued. 
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4/0 OPERATING SYSTEM NOTES AMD CAUTIONS 
4.11.1. 3*1 DISPLAYS/SUMMARY SU8-C0MMAND 

4.11.1.3.1 DISPLAY_SUMMARY SUB-CGMMANO 

PDT diss_pdt C 

metric* rat NAME » SREQUIRED 

title* tt STRING 

I 

This sub-command requests a statistics? summary report. This report 
includes such information as the mean* max ilium and minimum* and total 
number of elements of the specified metric. 

The METRIC parameter specif! as the metric to be reported* and is 
required. 

The TITLE parameter may be used to provide a title to he placed at 
the top of the report page. If omitted* the metric name Is used. 

4.11.1.3.2 OXSPLAY.DXSTRIBUTION SUB-COMMAND 

POT di sd C 

metric* m* NAME * SREQUIRED 

title* t i STRING 

limits* limit* It U II* 12 )* < 13* 14 )) i INTEGER 

d i sp I ay.opt ion* doi KEY flax_mln_botfnd» f irst_max_centered* 

sacond_max_centerad » max_min_bound 
x.interval* xi* KEY sel?_adjust* large* medium* small » 

sei f_adjust 
! 

This sub-command requests a distribution plot* which indicates the 
number of metric elements with each value within the observed range. 
The report consists of a frame Indicating X and Y axlses* with the 
possible values of the metric on the X axis* and the element count on 
the Y axis* DISPLAY^SINARY.LQG places asterisks within the frame to 
Indicate how many metric elements had a particular value. The report 
also displays the number of elements within the frame and the number of 
elements which exceed the frame limits • 

The functions of the METRIC and TITLE parameters are the same as in 
the DI$PLAY_SUMMARY sub-command. 

The LIMITS parameter can be used to define the frame boundaries. The 
defaults on the X-axis are the minimum and maximum of the contents in 
the counter. On the Y-axis* the defaults are the minimum and maximum 
number of elements among X- axis intervals. First value set defines the 
X boundaries. Second set defines the Y boundaries. First value in each 
set defines the lower boundary. f -l» can be used to specify a default 
boundary. 
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4. 11,1.3.2 OISPLAY.DISTRIBUTION SUB-COMMAND 



EXAMPLES* 

l«(( 50* 1000 )) X lower bound * 50* upper bound * 100C 

Y boundaries are default. 

1*1 C -1* 1000 )* X loner bound » default* upper bound « 1000 
( 10* -1 H Y lower bound « 10t upper bound * default 

The 0ISPLAYJ3PTIGN parameter can be used to select first maximum or 
second maximum C on Y-axis ) portion of the graph* FIRST_MAX_CENTERED* 
SECaND_MAXj:ENTERED and NAX.MIN.BOUND are the keywords. The default of 
this parameter Is H AX. M IN. BO UNO. 

The X.INTERVAL parameter can be used to determine the number of 
Intervals into which the X-asis of the frame is divided* 3 different 
sizes are aval iabl e* 

LARGE - X-axis is divided into 11 interval s| 
MEDIUM - X-axis Is divided into 21 Intervals; 
SHALL - X-axis Is divided into 101 Intervals. 

The default of this parameter is SELF.ADJUST. When default is used* 
the X-axis division will be fapen4 on the X-axis limits alone. The 
rules ares 

X.upper.bound - X.lower. bound <« 10 11 intervals 
X.upper.bound - X_lewer_ bound <» 500 21 intervals 
X.upper.bound - X.lower. bound > 500 101 intervals 

NOTES* 

1. The first and the last intervals on the X axis are one-half the 
width of the other X axis intervals. 

2. The X-axis upper limit as displayed may be slightly higher than 
the value specified in the subcommand* The rules ares 

11 intervals C X.upper - X. lower ) modulus 10 * 

21 intervals C X. upper - X.lower ) modulus 20 * 

101 intervals C X.upper - X. lower ) modulus 100 * 

4.11.1*3.3 DISPLAY.TIHE.DISTRIBUTXON $U8-C0M«AND 
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4.0 OPERATING SYSTEM MOTES AND CAUTIONS 

4.11.1.3.3 DISPLAY„JIME_DISTRI3UTI0N SUB-COMMAND 

pot dist<f.pdt( 

metric* mt NAME * $REQUIREO 

«etr lc_l iinl ts# mi: LIST 2.. 2 of INTEGER » $REQUIRED 

title* t* STRING 

) 

This subcommand generates a graph which plots metric values against 
time. The X-axis represents the time Intervals and the Y-axis 
represents the element counts of the metric. The asterisks placed 
Mi thin each time interval represent the range of element values semn In 
that interval. The report also generates the number of elements within 
the frame and the number of elements which exceed the frame limits. 

The METRIC parameter specifies the metric name to be reported. 

The METRICJLIMXTS parameter specifies the limits to be used for the 
Y-axis* The limits for the X— axis will come from the date and time 
parameters given on the 0EFINE.GR0UP subcommand. 

example? ml»{0»500) Y lower bound ■ 

Y upper bound » 500 

The TITLE parameter Is used to provide a title to be placed on the 
top of the report page. If omitted* the metric name wilt be used. 

4.11.1.3.4 DISPLAY_DESCRIPTIVE_DATA SUB-COMMAND 

POT dlsdd.pdt C 

group* g: NAME « SREQUIRED 

title* t* STRING 

) 

This subcommand processes the members of a group* rather than a 
metric. It displays values Cup to 256 characters long) for the 
descriptive data field of each statistic in the group* together with the 
number of times each value was encountered. 

The GROUP parameter specifies the group to be scanned* and Is required. 

The TITLE parameter may be used to specify a character string to be 
placed at the top of the first page of the report. If It is not 
included In the sub-command* then the name of the group is used instead. 

4.11.1.3.5 BUMP.GROUP SUB-COMMAND 
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4.0 OPERATING SYSTEM NOTES AND CAUTIONS 
4.11.1.3.5 DUNP.GROUP SUS-CQN^ANO 



POT dumg_pdt ( 

group* gi NA8E » SREQUIRED 

counter. fonati cf» LIST 1..63* 1..2 range of INTEGER 1..63 

title* t* STRING 

I 

This sub-command processes the members of a group rather than a 
metric. Each statistic Mithln the specified group is listed in full. 
This group dump is particularly useful for debugging group 
specifications and statistic definitions. 

The GROUP parameter specifies the group to he dumped* and is 
required. 

The COUNTER.FORNAT parameter specifies in what base the counters Mill 
be displayed. The default base Is 10, 

examples cf»C (1«.S*10)* (9. .63* 8)) 

Counters i — 8 Mill be displayed in base 10. 
Counters 9 - 63 wi 1 1 be displayed In base 8. 

The TITLE parameter may be used to specify a character string to be 
placed at the top of the first page of the dump. If it is not included 
in the DUNP_GROUP sub-command* the name of the group is used instead. 

4. 11. 1. 4 ££M£E&X£~MQM£JEii^_2yll=£fii$afia 

POT gengf_pdt ( 

group* gt HAHE :■ * SREQUXRED 
output* o* FILE * SOUTPUT 
permanent* p* BOOLEAN « FALSE 
I 

This subcommand selects a group of statistics defined by subcommand 
OEFINE.GPOUP* and writes the statistics to a legible file In a format 
suited for machine processing. 

The GROUP parameter specifies the group to be selected* and is 
required. 

The OUTPUT parameter specifies the local file name which contains the 
selected statistics. If It is not Included in the subcommand* the name 
SOUTPUT is used as the default file name. The attributes of the output 
f I le **i 1 1 be* 
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4.11.1.4 GENERATEJSRQUPJFXLE Sub-Coma! and 



FILE.CONTENTS - LEGIBLE 
FILEJ3RGANXZATI0M * SEQUENTIAL 
FXLE_PR0CES50R - UNKNOyN 
PAGE.FORMAT » CONTINUOUS 
PAGE.HIDTH * 80 

C Except for the file SOUTPUT* where the default attributes of 
SOUTPOT are used. ) 

If the same file name Is used for OUTPUT parameter In several GENGF 
subcommands* the order of the group statistics Mill be the same as the 
order of the GENGF subcommands. 

The PERMANENT parameter is a boolean value. If PERMANENT » TRUE* 
then a permanent file nith the same name specified in parameter OUTPUT 
will be created under the catalog $USER. If the permanent file Is an 
existing file* then a nam cycle ( one higher I nil I be created. The 
default value of this parameter Is FALSE. 

There %r9 some restrictions when parameter PERMANENT « TRUE Is 
specified. 

1. Parameter OUTPUT can not be the default value or SOUTPUT. The 
conflict of the file attributes will cause the subcommand to be 

rejected. 

2. Parameter OUTPUT can not be the same as In any previous GENERATE. 
GROUP.FXLE subcommands. The local file name conflict **l 1 1 cause 
the subcommand to be rejected. 

3. Parameter OUTPUT can not be the same as an existing local file 
name. The local file name conflict Hill cause the 
0ISPLAY.BIRARY.LOG to be aborted. 

The PERMANENT parameter Is not consistent with NOS/VE philosophy* and 
may be removed In a future update. This Hi I I not deprive users of any 
functional ity. 

Examples i 

CASE 1 i illegal usage ) 
defg g*optn.input s«evl000 

GENGF g-open.input PERMANENT*TRU£ 

CASE Z < illegal usage ) 
defg g*open_ input s*evl000 
defg g*close_input s*evl001 
GENGF g»open_lnput OUTPUT* INPUT.GROUP 
GENGF g«cios9_lnput OUTPUT«INPUT_GROUP PERHAN£MT»TRUE 

- COMPANY PRIVATE - 



SOFTWARE RELEASE BULLETIN 
NOS/VE (CYCLE 18) 



4-22 
84/03/12 



4,0 OPERATING SYSTEH NOTES AND CAUTIONS 
«* 11*1*4 6EN£RAT£..GR0UP_FIL£ Sub-Command 



CASE 3 I legitimate usage ) 
d*f§ g»open_input s«evlOO0 
defg g=»cl ose_J nput s*evl001 

GENGF g«open_input QUTPUT*INPUT_GROUP PERMANENT' 
GENGF g«close_input OUTPUT* INPUT_GRQUP 



TRUE 



Each statistic is output as one or more text tines* The first line 
contains the header information* including the number of counters and 
the size of the descriptive data string* The counters are output next* 
occupying as many lines as necessary* The descriptive data string is 
output last j on a single line* The format of each statistic in the 
output file Is sfiOHn below: 

> Contents 

stat is tic. I dent If ler 

stat 1st ic.code 

Julian date( yyyyddd ) 

timeC hh*mmiss*mi t I isecond ) 

job_name 

gl obal_task_l d C nnnn-mmm ) 

condens ing.fr equency 

numb er_of_ counters 

descri ptive_dat assize 

counter 1 C right Justified* 

counter 2 blank filled I 

counter 3 

counter 4 

counter 5 

t 

t 

s 
descriptive data 



ine 


from Ch* 


to I 


1 


2 


3 


1 


4 


9 


1 


11 


17 


1 


19 


30 


1 


32 


36 


1 


38 


45 


1 


47 


68 


1 


70 


71 


1 


73 


75 


2 


1 


20 


2 


21 


40 


2 


41 


60 


2 


61 


80 


3 


1 


20 


t 


t 


t 


* 
• 


i 


3 


n-1 


t 


t 


n 


Z 


80 



4*11*1*5 Xli£_gyiX_£u&:£fiiiaa4 



This sub-command has no parameters* It ends acceptance of 
sub-commands* and begins processing of the prior sub-commands to 
generate reports* 



4*11*2 THE ACTIVATE.STATISTICS COHHAND 



This GQmmAn4 is used to establish and enable one or more statistics 
to a given global binary log* It may be abbreviated as "ACTS*** The POT 
is: 
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4*0 OPERATING 5YSTEH NOTES AND CAUTIONS 
4*11.2 THE ACTIVATE_STATXSTICS COHNAMO 



PDT acts. command C 

statistic, statistics* st LIST OF NAHE » $REQUIREO 

type, t* KEY statistic* statistics, accounting, account, • •• 

engineering * statistic 
STATUS ) 

The STATISTIC parameter specifies one or more statistics to be 
established and enabled* Each statistic Is specified as two alphabetic 
characters followed by a decimal number} for example, AV2600Q7* A list 
of statistics, enclosed in parenthesis as p%r SCL syntax, nay be 
specified* 

The TYPE parameter specifies the global binary log to which the 
specified statistics are to be enabled* Only one log may be specified 
In each ACTIVATE_$TATIS?IC command* If It is desired to send a 
particular statistic to more than one log, multiple ACTIVAT£_5TATISTIC 
commands may be used* 

4.11.3 THE DEACTXVATE.STATXSTXC CONHAND 

This command Is used to disable one or more statistics that had 
previously been enabled to a particular log* All statistics remain 
established, and If they are enabled to another log, that connection 
remains undisturbed* The command name may be abbreviated as DEAS* 

PDT daas_command C 

statistic, statistics, si LIST OF NAHE » $REQUIRED 

type, t* KEY statistic, statistics, accounting, account, ••• 

engineering * statistic 
STATUS I 

The STATISTIC parameter specifies one or more statistics to be 
disabled* Each statistic Is specified as two alphabetic characters 
followed by a decimal number! for example, AV26O007* A list of 
statistics, enclosed in parenthesis as per SCL syntax, may be specified* 

The TYPE parameter specifies the global binary log to which the 

specified statistics are to be disabled* Only one log may be specified 

In each DEACTIVATE^STATISTIC command* If It is desired to disable a 

particular statistic from more than one log, multiple 
D£ACTIVATE_STATISTIC commands may be used* 

All statistics specif lad in the OEACTIVATE.STATISTIC command must 
have previously been enabled to the specified log, either by an 
ACTIVATE.STATISTI'C command or by a program Interface call* 
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4. 11.4 ACTIVATE_INTERVAL_STATISTIC 



The ACUVATEJtNTERVAL_STATISTIC (ACTIS) command Is used to establish 
and and enable these statistics which are emitted on an interval basis 
to a given global binary log* This command can only be issued from the 
system console* 



POT actis.command ( 

jms_lnterval# JM Integer 1**999 
pms.lntervalj pi* integer 1..999 
status ) 



The STATISTIC parameter specifies the statistics to be emitted* The 
only valid statistics of this type currently is the QS21CC0C at\4 
OS210001 statistics* 

The JWS.INTERVAL parameter specifies at what time Interval the jms 
statistic C0S210000) should be emitted* The default value is 1 minute* 



The PHS_ INTERVAL parameter specifies at what time interval the PMS 
statistic C0S210001) should be emitted* The default value is 5 minutes* 

iUla2.Q£m£II^Z£.I(II£&3UUL^ZAI2SIIC 

The DEA€TIVAT£_INTERVAL_STATISTIC <DEAIS> commmand is used to disable 
interval statistics that have previously been enabled to a particular* 
log* This command only disables the OS21000C and PS2100O1 statistics* 
This command can only be issued from the system console* 

POT deals. command C 
status ) 

4.11.^ STATISTICS AVAILABLE IN NOS/VE 

This Is a list of the current statistics available on NOS/VE* 
STATISTIC Hhm COUMTER/OESCRIPTIVE DATA 



Mtzmom 



Accounting CP time 



CI? Total CP increment 
C2i Job-mode CP time incr* 
C3* Honl tor-mode CP time incr* 



AV260O01 



Accounting Page Faults 



Cls Total page fault incr* 
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4*11.5 STATISTICS AVAILABLE IN NOS/VE 



AV26O0O2 
AV 26000 3 
AV 260006 

AV260007 

AV 26000 8 
CL 170000 



JN180000 
JH180001 
JM180002 

JH180003 



PH230000 
9N 230001 

mzzoooz 

PH 23000 3 



Accounting working set 
Accounting Ready Tasks 
Accounting Begin Accnt. 

Account I ng End Account 

Accounting SRU's 
Display message command 

Command names 

User name 
Jot) name 
Jon mode 

Jon end 



Task begin 

Task Starting Procedure 

Task name 
Task end 



PH230004 



Loader begin 



Cl^ Current W.S. size 

CI » Current ready task count 

DO* 1-31 - account name 
32-33 - U » 
34-64 - project name 

Clt. Total job SRU«s 
C2-* Totai job CP time 

CI* Totai SRU increment 

DO: String specified in 
command 

DDs Name of command; upper 
case* 31 characters 

DO: User name! 31 characters 

DD: User's job namef 31 chars 

DD* » INTERACTIVE* or »BATCH»s 
11 characters 

CI s CP time - job mode 

C2* CP time - monitor mode 

C3s Page fauits 

C4i Page-ins 

C5i Page-reclaims 

C6* Page-assigns 

None 

DO* Starting procedure namel 
31 characters 

DO* Task name; 31 characters 

CI* CP time - job mode 

€2* CP time - monitor mode 

C3« Page faults 

C4* Page- ins 

C5i Page-reclaims 

€6* Page-assigns 

none 
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mzm-ms 



Loader end 



FC 580000 



Fortran Compilation 



FC 580001 



Fortran Program Unit 



€5210000 



JMS- Interval 
(job-memory interval) 



OS 210001 



PH$— interval 
(paging-monltor Interval) 



CI 
C2 
C3 
C4 
C5 
C6 

Ci 
C2 
C3 
C4 
C5 

00 
CI 
C2 
€3 
C4 

CI 

C3 
C4 
C5 

C6 
C7 
€8 
C9 



it 
Cllt 

CI 2* 

C13* 
C14* 
C15» 
C16* 
CI?* 
C185 

CI* 
C2* 

C3* 
€4* 
C5* 
C6t 
C7* 
€8t 
C9s 
CIO* 

cm 

C12t 



CP time - job mode 

CP time - monitor mode 

Page faults 

Page- Ins 

Page-reclaims 

Page-assigns 

Task time in compiler 
Hon I tor time 
No* of lines compiled 
No* of statements 
No* of program units 

Program uni t name 
Task time for unit 
Monitor time for unit 
No* of lines in unit 
No* of statements 

free pages 

aval I able pages 

available modified pages 

Mired pages 

shared pages 

fixed pages 

10 error pages 

job shared pages 

job working set pages 

snapped jobs 

ready tasks 

interactive class 

batch class 

site class 

site class 1 

site class 2 

site class 3 

maintenance class 



pf aval labia 

pf available modified 

pf disk read 

pf new page 

pf locked 

pf 10 reject 

force aggresive 

aggresive aging 

aggresive aging 
aggresive aging 
write aged page 
mr cycle 



aging 

shared queue 
job queue 
failed 
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C13J 
C14« 
C15« 
C16* 
Cl7i 
C18* 
CI 91 



cycle average duration 

de I ay 

delay average duration 

nalt 

wait average duration 
mr write modified pages 
mr write modified pages 
average duration 



mr 
mr 
mr 
mr 

mr 



4.12 bzgmmii&BiMLiMiim 



The ADMXNISTEft_USER utility can be run from a baton job or SCL 
procedure contrary to what the Family Administrator for NOS/VE 
Usage Manual says. 
PSRs NVEA045 and NVEA046 



2. Great care should be tafcen using 
more than 20 users are deleted 
there is a good chance all users 
PSRs NV0D096* NV0E061* HV0E062 



the DELETE.USER subcommand. If 
since installation of the system* 
mIM be lost. 
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5 . EEQiUCL-SSOiaiES. AUJLXAUXUttS 



5.1 ClfilL 

1* When using DEBUG to breakpoint on a multi-line statement* the line 
number supplied to DEBUG must be the last line number of the 
statement. 
CILA498 

2. Run-time error messages* such as RANGE ERROR* don't display the 
bad value. 

CILA575 

3. A large string variable is miscompi led with the wrong size. 
CI LA 774 

4. CYBIL aborts with CGI error 101* 51# 52* and 38 with no listings. 
PSRs CILA727* CILA785* CILA787* CILA679 

5. CYBIL aborts with "ring number 2ero*. 
PSR CILA768 

6. CYBIL aborted without any diagnostic. 
PSR CILA755 

5.2 COfiOL 

1* If a USE declarative isn't present* then an I/O error occurring 
during file Input or output causes the job to abort with CS 
569260* The text of that message reports "I/O error ..."# but It 
doesn't show the underlying reason C for example* "parity error"!. 
Hence* the user should be watchful to Include USE declarations for 
any file where full ^rror messages are desired. 

2. The COBOL READ REVERSE statement does not work. If used* it will 
loop indefinitely on the first record and never take the AT END 
path. This is the result of SAW falling to set the file position 
to 801. 

PSR NVOE044 

3. Two consecutive instances of OPEN OUTPUT on the same indexed 
sequential file will not cause a message warning that the data has 
bmn evicted by the second OPEN. The user should refrain from 
Issuing another OPEN OUTPUT once the f I le has been created. 

PSR AA8A106 

- COHPANY PRIVATE - 



5-2 
SOFTWARE RELEASE BULLETIN 

84/03/12 
NOS/VE (CYCLE 18) 



5.0 PRODUCT SET NOTES AMD CAUTIONS 

5*2 COBOL 



5 . 3 £Xi£.8AM£££l£&I.ilXIiXI£ 

1* Do not use the file name INPUT In batch lode* It is always a null 
<empty) file with no data In It* Choose a different nut* This 
affects migration of jobs from NOS* where the name INPUT was the 
job»s input deck* On NOS/VE use the COLLECT.TEXT command to 
create the input data* 

2* When using FHU and inside Interstate Communication Facility* do 
not do a CLEAR on the EX£CUTE_INTER5TATE COMMAND. This will clear 
FMU checkpoint files and render FMU inoperable* 

3. If the 130 Interstate Communication Facility job aborts* the 
corresponding 170 FHSLAVE job becomes hung and does not return 
previously attached files* These FHSLAVE jobs remain at control 
points and continue to be CPU and memory overhead* Corrective 
action should Include for the user or operator to drop the "hung 
jobs** They can be Identified at a control point as 
"FHSLAVE* INITIAL"* "FHSLAVE*NaRHAL , •* or "FHSLAVE* ABNORH". 
PSR NV0E735 

5.4 EflfilRAM 

1* When using READ {*«•*) In batch jobs* a file containing the 
4%slr%4 input must be connected to $INPUT by 

CREATE_FXLE_€QNN£CTION or equated to INPUT on the FTN program 
statement or LOO statement* 

2. If INPUT or OUTPUT is opened using an OPEN statement* the OPEN 
statement must be changed to use SINPUT or SOUTPUT* 

3* To insure correct listings and improve compilation performance* it 
is necessary to prevent the listing file and the errors file from 
being the same file* In batch Jobs* both would default to 
SOUTPUT. To avoid this* set the ERROR parameter on the FORTRAN 
command to a file reference dlffeent from that of the LIST 
parameter* 

4* Utility subprograms CALL CONNEC and CALL DISCON do not work. 
Their use will cause your program to abort in execution. 
PSR FN8A90O 

5. RUNTIHE.CHeCKS'NONE should be specified In addition to OPT-HIGH In 
the FORTRAN command options when the objective is to achieve the 
fastest possible execution time for a FORTRAN program. The 
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5.4 FORTRAN 

compiler generates runtime checking code by default at ail OPT 
levels* unlike FTN5 on the 170 which generates checking code oniy 
if explicitly requested. Checking code can have a considerable 
impact on execution time* since every array element reference with 
a variable subscript generates a call to a library routine. 
OHE.TRIP.OO-ON should also be selected to improve execution time 
if all DO loops in the program have an iteration count of at least 
one. 

6. Mben compiling at QPT»HIGH# the FORC£D_SAVE«ON option should be 
used for any subprogram which relies on the values of its local 
variables or arrays being saved between calls to the subprogram 
but does not use a SAVE statement to retain their definition 
status. At QPT*HIGH local variables and arrays which are not 
saved ^re normally allocated on the runtime stack* so that their 
values are lost after the execution of a RETURN or END statement 
in the subprogram. At 0PT*L0w7DEBUG local variables and arrays 
are always allocated to a static memory segment so that saving is 
always in effect* as it Is on the 170 for non-over I ayed FTN5 
programs compiled at any OPT level. 

5.5 MlMA!&££_A£££5£-MXlieDS 

A job using an indexed sequential file will fail due to entry point 
errors from the loader. 

The following command executed earlier in the job will correct this* 

$£T_PROGRAn\_ATTRI8UTE$ TERHtNATION_ERRGR_tEVEt«FATAl 
or SETPA TEt»F 

PSR NV0E276 

5.6 SaUE££-£flaE.mXLlIX 

1. The SCU editor command SE ARCH.BACKWARD' will hang if asked to 
locate multiple occurrences of a range of text. A terminate break 
will stop the hung command and allow the user to continue editing. 
PSR SC8A027 

2. An anomaly can occur when some modifications are excluded when a 
deck is expanded. An example is below* 

tine I version 1. 
is introduced by modification A. Modification 8 replaces this 
I Ine with 

tine 1 version 2. 
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Then modification C In turn replaces this line with 

Line 1 version 3. 
If one expands the deck with modification 8 
lines introduced fey modifications A and 
COHPILE file. 



excluded both the 
C will appear in the 



5.7 ££0&yCJL^£L.=.&£fiUfi 



1. When an unseiected even occurs in a ring lower than the ring in 
which it Is running* DE8UG Incorrectly informs the user that the 
error occurred in the procedure which called the faulty procedure 
In the lower ring. 

2. DEBUG and CYBIL do not have a run-time Interface. Therefore* a 
program which aborts due to "CYBIL run time error* cannot be 
properly trapped by DE8U6. Instead* the DEBUG trap occurs in the 
CYBIL error processor! all dynamic variables (at the point of 
actual error) have been freed by the time DEBUG gets control. 



5.8 Q£L.iIi*£.tiAMU&i£ 



1. The HELP abbreviation* HEL* is broken. 

2. On line Manuals will be documented In the NQS/VE Installation and 
Upgrade Reference Hernial for Release 1.1. 1. Until that time* the 
Installation process has been described earlier in this document 
in section 3.1.2.6 and the maintenance process will be described 
in this section. 



Inst a I led 
fol lowing* 



into the $SYSTEH_«ANUALS subcataiog will be the 



FORTRAN 
F0KTRAN.T 

SORT 
SORTJT 

HIGRATE 

NOS/VE 

COBOL 

C0B0L_T 

OCH 

SCL 

SCU 

COHTEXT 

MESSAGES 



{Reference ffanual! 

(Tutorial) 

(Reference Manual) 

(Tutoriail 

(NOS to NOS/VE Migration! 

(Default Manual for EXPLAIN) 

(Reference Manual! 

(Tutor iall 

(Object Code Ngmt Reference Hanual! 

(System Command Language Reference Manual) 

(Source Code Utility Reference Hanual! 

(On Line Hanual Author f s Guide! 

(NOS/VE Diagnostic Hess ages) 
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«nd a MAINTENANCE subcatalog which contains the SCU source library 
of all the manuals and the binding procedure for creating new 
"bound* manuals. 

The source Is being distributed to allow customers the capability 
of tailoring the manuals for their site. Source libraries contain 
modifications reflecting the revision level documentation changes. 
This not only gives the benefit of a "revision packet* to identify 
new features and changes* but also aids the update process for te 
site version of manuals. 

To tai lor a manual for a site* 

a. Create a new source library or additional cycle of 
Ssystem. manual s.mii ntenance. source_i Jbrary reflecting the 
modifications. (Note that each manual is contained in a 
deck. Decks are grouped by product.) 

b* Execute $system.manuai$.m*intenance.binding_procedure within 
the Ssystem user or maintenance user number to create new 
manuals. 

PROC blnd.fflanual s* blnm* bind.manual 

manual* manuals* mi LIST OF MAME or KEY all * all 

base* b* FILE » SSYSTEN. NANUALS. HAINTENANCE.SOUfcCE_LIBRAmr 

catalog* e* FILE * SUSER. NANUALS 

stat us I 

where* 

manual * sou deckname(s) of manual is) desired to be 

created 

base * source library used for compilation 

catalog » resultant catalog for new manual Cs) 
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The BATCHIG printer driver does not correctly handle long lines lover 
135 characters). The extra characters are either dropped* overprinted* 
or cause the page to be spaced erratically* 

NS2C121 
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7.0 ££A-L£m5 



The folowlng tables show the microcode and controlHare levels that 
Mere used to validate the NOS/VE system on the specified hardware 
systems supported* These tables show the latest official FCA levels of 
the hardware and microcode and the necessary modifications (deviations) 
required to support the NOS/VE system* Tables It 2* 3# and 4 correspond 
to the C17Q-815, €170-825. C170-835, C170-845* and C17C-855 systems, 
respectively* 
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19 
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A1.0 2£¥l££-£ti£EA£X££ISII££ 

A 1.1 UISK.J>£Jtt££5 

Al.l*l PHYSICAL CHARACTERISTICS 

344-4X 885-lx 

Spindles/Cabinet 
Cyl I nders/Splndl e 
Tracks/Cyl inder 
Sectors/Track 
8ytes C8 bit)/Sector 

Al*i*2 LOGICAL CHARACTERISTICS 

Al* 1*2.1 l&L$imLQ2X 

• Al location_unit - The quantum of assignment of mass storage space 
to a file* An all ocation.uiilt Is a power-of-two multiple of 
consecutive DAUs* At present* the tl location.uni t Is not 
selectable on a file by file basis; all end-user files default to 
16384 byte allocation* 

• Device. a I location_uni t <DAU) - The quantum of allocation of a mass 
storage volume (spindle)* NOS/VE views a device as an array of 
DAUs which individually or as a contiguous group leal led an 
al I ocat ion_unl t ) nay be assigned to a mass storage file* A DAU 
consists of an integral number of HAUsi the ratio Is device 
dependent and dependent upon the granularity of allocation NOS/VE 
can afford to provide for a particular device* A DAU may span 
tracks but nmw^r sp^ns cylinders of a device* 

• Large_sector - A control Mare capability provided by the 7155 class 
of mass storage controller which logically groups four physical 
sectors into one for the purpose of decreasing device driver 
overhead* The tern f HAU* is preferable to Marge sector* since 
not all controllers may provide this capability to NOS/VE* Note 
that a lar§e_sector on an 885 device Is composed of four physical 
sectors each of which contains 516 bytes* The last 33 of these 
bytes are not transferred when a physical sector is read in small 
sector mode* Therefore* It is possible that NQS/VE will encounter 
additional bad-spots on a device previously only accessed in smell 
sector mode* The DL8 diagnostic is provided to verify the data 
field of a large sector* The control ware and NOS/VE consistently 
report failure status in terms of physical Ismail) sector ^44ress» 
The large sector diagnostics such as DL8 and FLD* however* display 
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large sector 

recommended 

status. 



%4dr&$$* Hhen using the I atter diagnostics* it is 
that one rely on the sector address in the detailed 



Minimum_addressable_unlt (MAO) - The 
supported by a ?? driver* The MAU Is 
used to normalize the various device se 
Processor* When the CP prepares reques 
It thinks in terms of a number of MAUs* 
down the MAU into physical address an 
If a mass storage device has a sector s 
two bytes in length Csuch as the 844-4 
at the start of a sector and finish in 
sector; the number of sectors spanned i 
may span tracks but never spans cylinde 



quantum of 
a software c 
ctor sizes f 
ts for mass 

The PP dri 
d sectoring 
i2e which Is 
x)* then the 

the midst 
s device 4%p 
rs of a devi 



data transfer 

oncept which is 

or the Central 

storage devices 

ver then breaks 

considerations* 

not a power of 

MAU wi II begin 

of the last 

en dent. An MAU 

ce* 



• Page_size — A power of two number of bytes ranging from 512 bytes 
to 65536 bytes. NOS/VE is presently constrained to supporting 
page sizes of 2048* 4096* 8192 and 16384 bytes* The constraint is 
a file system constraint related to a)not wanting more than one 
page per MAU ^nd b) not wanting a page to span tracks* 

*l.l.2*2 iQS/i£-.aisli-Mflliim&«Ailafijaiiiiii 



844~4x 



Sectors/MAU 

MAU/Track 

DAU/Trick 

OAU/Cyl Inder 

DAU/Spindle 

Bytes /MAU 

Bytes /Track (a*j.) 

Bytes /Cy I inder 

10**6 Bytes/Spindle 

10**6 Bytes/ Segment 



885-lx 



5 


4 


4*8 


8 


2.4 


4 


44 


160 


37035 


134880 


2048 


2C48 


9485*4 


16384 


180224 


655360 


151*6 


552.46 


2147.5 


2147.5 



Al.1.2.3 SifliZME-EilfiUllgfiatiJia 



Allocation Unit Sizes 
<C onsecut i ve DAUs ) 

1 

2 

4 

8 

16 

32 



844-4x 


885-lx 


C bytes 1 


(bytes) 


4096 


4096 


8192 


8192 


16384 


16384 


32 768 


32768 


65536 


65536 


131072 


13107 
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64 


180224 


262144 


128 


180224 


524288 


256 


180224 


655360 



A1.2 IA££J2£¥I££S 

*1.2.1 PHYSICAL CHARACTERISTICS 

Al.2.2 LOGICAL CHARACTERISTICS 
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A2.0 M$$.m&M£-¥OUiME-JMA££i!£liI 

A2 . 1 5XSI£iLIHSI4LLAIiafcL£E££A£ AIIOM 
A2*l.l PREPARING 844 AND 885 DEVICES 

All 844 and 885 volumes are formatted at the factory* Neither 844 
nor 885 volumes need to be reformatted to be used by NOS/VE. Volumes 
used by NOS are Interchangeable with NOS/VE without re-formatting. 
Utility Map processing Is Identical In all aspects* However * with the 
exception of the Factory Map and the Utility Map* the data recorded on a 
volume by NOS cannot be Interchanged with NOS/VE and vice ^ersa* 

NOS/VE does not honor the CTI deadstart sector content* Therefore it 
does no good to install CTI or CML on a NOS/VE device nor can one expect 
this information to remain intact across mixed system use of the device* 
e*g* first NOS* then NOS/VE and then NOS again* CTI and CML should 
only be installed on the NOS deadstart device or an alternate device 
used only b^ NOS* 

Prior to attempting NOS/VE system Installation* the following 
procedures should be performed either on-line using MALET on NOS or 
off-line using QEMQT* The objective of these procedures is to ensure 
the correctness of the Utility Map maintained on each device* The 
INITIALIZERS.. VOLUME process described later uses the Utility Map to 
avoid defects (bad-spots) on the disk surface* 

A 2. 1.1.1 Sl£££$_&£aii£lt3:£_IULli£& 

a* For the NOS/VE system deadstart device it is recommended that the 
SCAN DISPLAY FLAWS module of the FMU diagnostic be used to display 
all the sectors which have track or sector flaws set* This 
display must then be compared to the display of the Utility Map* 
Any flawed sectors not in the Utility Map must be added to ensure 
that the Installation of the NOS/VE system will go smoothly* This 
procedure should be expected to take at least 10 minutes* Refer 
to the discussion of defect management below for further insight 
as to why the above procedure is recommended* 

to* Use the 0L8 diagnostic to write/read large sectors on Cylinder 0* 
Track of an 885 deadstart device. This accomplishes two thlngst 
1) it proves that track can later be written by 
IMITIALIZE^MS.VOLUME CINIMV) 2) it ensures that fictitious 
unrecovered checksum failures %rm not encountered by INIMV when 
performing NOS/VE label searching. Note that it is totally 
unnecessary to write large sectors on the whole device because 
NOS/VE ntivmr reads a sector that it has not first written I except 
during INIMV label searching)* 
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A2.0 HA5S STORAGE VOLUHE NANAGEHENT 

A2*l*l*2 Volumes Other Than the System Deadstart Device 

The above procedure Is strongly recommended for each mass storage 
device to be used by N03/VE* 

A2.2 Xi*XIl*iXl£_!l£-y.OiUl*£ 

A2.2*l INITIALIZATION OF 844 AND 885 VOLUHES 

The INITIALIZE_HS_VQLUH£ UNIHV) subcommand of the Losical 
Configuration Utility CLCU) Is used during the NOS/VE installation 
process to prepare mass storage volumes for use by NOS/VE* The 
Initialization includes writing a NOS/VE software label on the volume 
and processing the Utility Map located on the volume Itself* Before 
proceeding with the initialization of the vol use* INIHV attempts to read 
a NOS/VE label from one of three possible locations on the volumes NAUs 
1* 2 and 3 are tried in succession* This is done as a protection 
against operator error which could destroy files on the volume if 
re-lni tl al ized* 

If an 883 volume has not been previously initialized by NOS/VE or has 
not been written in large sector mode by diagnostic software* then an 
uncorrected eheckword failure will be reported for each of the three 
attempts made by INIHV to read a NOS/VE label* Under the previously 
stated conditions* the reporting of these 3 failures is £*££££&l2 and 
should aai be a source of concern* The 3 locations read by INIHV* in 
the order attempted* are* 

l*Cyllnder 0* Track 0# Sector 

2. Cylinder §• Track 0* Sector 4 

3. Cylinder 0. Track Q, Sector 8 CIO octal) 

Note that for an 844 device* checkword failures are aat expected 
during INIHV label checking* 

Once convinced that It is not destroying files by mistake* INIHV 
proceeds to write a NOS/VE label on the volume* Next it processes the 
Utility Hap recorded on the volume* The location of the Utility Nap is 
device dependent as is the content of the map* However the manner in 
which the Utility Bap Is read by the NOS/VE driver is device independent 
as fol lows* 

The 844 and 885 Utility Haps are written In small sector format by 
the factory and by diagnostic utilities* The Utility Naps fall 
somewhere within a NOS/VE HAU < logical sector of 2048 bytes)* The 
driver is given an HAU ordinal by INIHV m4 the driver attempts to 
deliver an HAU* This Involves reading either 4 or 5 small sectors 
depending upon the device* Because some of the sectors have b^en 
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A2*2*l INITIALIZATION OF 844 AND 885 VOLUMES 



nr I ta-protected by the controller and sows have not the driver attempts 
to read each snail sector using the following sequence of commands* 

l«Read protected sector (34) 

2*Read (4) 

3. Read factory data (301 

4. Real utility map (311 
If an address error Is returned for a particular sector the next read 
function Is tried for the same sector until all 4 generic read functions 
have been tried or the read Is successful* whichever occurs first* 
Intervening address error failures are not reported* only the last of 
the four* Any failure other than an address error detected after any of 
the four generic reads causes request termination and is reported* 

12*2,1*1 a£jk_U t ilU*-8AE-££asiS£iajl 

The INTIALIZE_MS_VOLyME subcommand uses the Utility Hap located at 
Cylinder 822» Track 0* Sector 2 to flaw defects which have been detected 
at the factory or by the CE and recorded in the Utility Map* 

The Utility Map Is an array of •* 161 flaw entries* Each entry 
documents either a track flaw or a sector flaw* Sector flaws are 
recorded In the physical (small) sector numbering scheme* 

INIMV logically flaws the DAU affected by a sector flaw and the 3 
CAUs affected by a track flaw. Note that because of the data mapping of 
the 844 device a track flaw will also logically flaw from to 4 small 
sectors on the next track* 

To support diagnostic use of the device* INIMV also flaws cylinders 

820 * * &2.£m 

A2 * 2* 1 . 2 £M.U£iiiil~ll&-££&££&£ifiil 

The INITIALIZS.MS.VOLUNE subcommand uses the Utility Map located at 
Cylinder 84I» Track 1# Sector 1 to flaw defects which have been recorded 
there by the factory or by a CE* 

The Utility Map is an array of • • 161 flaw entries* Each entry 
documents a track flaw* 

INIMV logically flaws the 4 OAUs which are affected by a flawed 
track* 

To support diagnostic use of the device* INIMV flaws cylinders 
841**842* 

- COMPANY PRIVATE - 



A2-4 
SOFTWARE RELEASE BULLETIN 

84/03/12 
NOS/VE (CYCLE 18) 
NOS/VE Peripheral Naintenance and Support 



A2*Q HASS STORAGE VGLUHE MANAGEMENT 
A2*3 VQLUHE DEFECT MANAGEHENT 



*2*3 XflLUBfi-MEECLJUMAfiEllEiil 

A2*3*l RECOHHENDATIQNS FOR 844 AND 885 DEVICES 

Once NOS/VE has been installed and ail of its mass storage volumes 
have been Initialized* it is possible that additional defects will 
appear on the surface of a volume* 

The symptom of this defect is likely to Initially be a recovered 
read/write failure* If the same sector is reported repeatedly, one may 
wish to take action to avoid the loss of performance incurred by 
repeated disk driver recovery attempts* The SAVE DATA and RESTORE DATA 
capabilities of the FHU diagnostic utility may be used to relocate the 
failing sector* This capability only applies to 885 devices as these 
devices pro^idm two spare sectors per track for this purpose* The 
procedure must be performed off-line to NOS/VE* Refer to the discussion 
of off-line flatting for further Information* 

If the symptom of the defect is an unrecovered read failure* the 
recommended procedure is to delete the file to which the falling sector 
was allocated* The deJetlon of the file should only be done after 
repeated attempts to read the file have ail failed* It Is possible that 
an unrecovered read failure may actually be caused by an intermittent 
problem with the mass storage controller or storage device logic* 
Therefore* repeated read attempts may eventually succeed depending on 
the cause and duration of the problem. If the file is deleted* NOS/VE 
Hill ensure that the falling DAU Is not allocated to another file* 
Refer to the on-line flawing discussion for further information* 

If the symptom of the defect Is an unrecovered write failure* the 
recommended procedure is to make a copy of the file* NOS/VE keeps 
unwritable modified pages of a file in memory until the file Is detached 
by all Jobs which may be sharing the file* Therefore It is possible to 
$ake a copy of the file without re-encountering the original defect* 
Once a copy of the file has been made* delete the original file and 
NOS/VE will ensure that the failing DAU is not al located to another 
fi le* 

If an unrecovered read/write failure occurs on a file which Is 
critical to continued NOS/VE system execution* the only recourse is to 
take NOS/VE off-line* flaw the sector or the track* re-initial Ize the 
volume on which the flaw was set and perform an installation deadstart* 
It will be necessary to restore all permanent files* 

A2*4 aHLMS-EUlOiiS 

Once a volume has been Initialized using the INITIALIZE_&S_VOLUH£ 
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subcommand* NOS/VE pays no further attention to the Utility Hap on tha 
volume* unless of course the volume should again he subject to 
initialization* 

NOS/VE does not update tha Utility Hap under any circumstance* Only 
the diagnostic utility* FHU* is used for this purpose* Refer to the 
discussion of off-line flawing below. 

A2.4*l NOS/VE SOFTWARE FLAWING OF UNRECOVERED HEDIA FAILURES 

NOS/VE dynamically flaws defects detected on falling read or write 
operations* Defects are logically flawed in the software allocation 
tables stored an the individual devices! this is referred to as 
software-flawing* 

When a DAU is software-flawed the file to which the DAU Is assigned 
can continue to be accessed* If the cause of the defect is an 
Intermittent problem subsequent reads of the DAU may not re-encounter 
the failure* Therefore* NOS/VE f s philosophy is to not set sector or 
track flaws in the Utility Hap for unrecovered media failures* However* 
If the read failure persists and the file is later deleted from the 
system the bad DAU will not be re-assigned to another file. The same is 
true for DAUs which are the object of falling writes except the write is 
not re-attempted* 

A2.5 QtEzLlM-lLhUM 

Only a maintenance person (CEJ should perform physical flawing* It 
Is not recommended to set either a track or sector flaw on an 844 device 
or a track flaw on an 885 device unless the defect prevents continued 
NOS/VE system execution* Setting such flaws on a device used by NOS/VE 
will destroy data recorded in the sector or track* If the defect is not 
critical to NOS/VE system exacutlon then on-line flawing Is sufficient* 
Refer to the discussion of defect management above* 

If a particular sector is causing system performance degradation due 
to repeated successful failure recovery* one may decide to relocate the 
data? this is an option only on an 88 5 device* 

Each track on an 885 device has two spare sectors* The Utility Hmp 
on the device has a defective sector list* If there are already two 
defective sectors reported for the affected track* no data relocation is 
possible* If there is a spare sector* the FMU diagnostic utility may be 
used to relocate the data in the failing sector to the spare sector* 
The 7155 controlware automatically skips defective sectors during a read 
or write* The FHU diagnostic utility provides modules to SAVE DATA* 
FLA« SECTOR and RESTORE DATA. The SAVE DATA writes the track with the 
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suspicious sector to a maintenance track* Next the FLAM SECTOR module 
Is used to set a sector flaw. In addition to flawing the suspicious 
sector* FLAW SECTOR automatically rewrites the address field in all 
higher numbered* non-defective sectors to Increase the logical sector 
number stored in each address field by one* Refer to the discussion of 
setting sector flaws below* Finally* the RESTORE DATA module Is used to 
copy the original track contents from the maintenance track to the 
original track* 

Flawing can be performed only when NOS/VE Is off-line* However* 
flawing may be performed on-line on NOS using HALET or off-line using 

DEHOT* 

Failures reported to the HDD console have cylinder* track and sector 
reported in decimal* Refer to the section on HDD failure reporting to 
determine how to find the octal representation* If necessary* 

The FMU package is used to perform flawing* FMU Is capable of 
accepting the flaw address in either octal or decimal* Octal values for 
cylinder* track and sector are the default* A post radix of D indicates 
the specified value is in decimal* 

A2*5*l SETTING SECTOR FLAWS OH THE 385-1X DEVICE 

The failure data displayed to the HOD console or logging in NGS/VE f s 
Engineering Log provides the %d6ress of a defect In terms of cylinder* 
track and sector* The sector address is laalsji and not sli£&l£jl* 

This distinction can best be explained by an examples 

Suppose that track N has no flawed sectors* Then a defect is reported 
fey NOS/VE on this track at sector 0* In this case sector is both the 
logical and physical address of the defect* Some time later another 
defect Is reported at the same address* l*e* sector 0* This time the 
physical sector number is 1 because physical sector has already been 
flawed* 

Because the logical address Is reported In the failure data* the 
maintenance pmrson must use FHU to read the Utility Hap map to determine 
the location of any existing defective sectors on the track* Then the 
logical sector address must be converted to a physical sector address 
and the sector flaw set based on the fitueslaai address* The mapping from 
logical to physical is as follows* 

P*L + 
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yhere* 

P is the physical sector address to be given to FLAW SECTOR module 
of FNU 

L is the logical sector address reported 

D is the number of defective sectors already set whose address is 

less than or equal to L 

It Is better to set sector flaws than track flaws because the 885-lx 
does have the two spare sectors per track for this purpose* Therefore 
up to two sectors pbt track isay be flawed without losing the full track 
capacity* Once a track flaw is set then NOS/VE will not use the track* 
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M.C im_£imaL£-£MUJB£-&££QRIIti£ 



The NOS/VE monitor will format and display failure data on the HOD 
console for every unrecovered disk failure regardless of the impact the 
failure has on the system. If the system can continue executing CP 
tasks/ the failure data will also he put In a binary engineering log* 

If the system cannot sustain task execution* the failure data will 
only be displayed on the HDD console* no error logging can occur as no 
other logging media (save real memory) Is available to the monitor* 

The folfowinj information will be displayed for unrecovered disk 
fai lures* 

a* Channel number of disk controller tin decimal) 
fo* Equipment number of disk controller 
c. Disk unit number (in decimal) 

844-4x unit numbers are •• 7 

885-lx unit numbers are 32 . . 47 
d* Logical operation performed at time of failure 

READ 

WRITE 

WRITE INITIALIZE 

READ FLAW MAP 

DRIVER INITIALIZATION 
e* English description of failure symptom if it can be determined 

SOFTWARE FAILURE - (CP/PP interface failure! 

INDETERHINATE - (channel or controller or unit) 

INPUT CHANNEL PARITY 

OUTPUT CHANNEL PARITY 

CONTROLLER FAILURE 

UNIT FAILURE 

FUNCTION TIMEOUT (not RAM-parity induced) 

UNIT RESERVED 

CONTROLLER RESERVED 

SEEK FAILURE 

ERROR IN CHECKWORD 

CONTROLLER RAH PARITY 

INCOHPLETE SECTOR TRANSFER 

UNIT NOT READY 

UNIT OFFLINE OR NOT CABLED (844) 

UNIT READ ONLY SWITCH ON 1885) 

CHAN ENABLE SWITCH OFF/UNIT NOT CABLED (885) 

FLAWED TRACK 

FLAWED SECTOR (844) 

SECTOR ADDRESS HISCONPARE 

CYLINDER ADDRESS HISCOHPARE 

LOST CONTROL WORD 

- COMPANY PRIVATE - 



A4-2 

SOFTWARE RELEASE BULLETIN 

84/03/12 
NOS/VE (CYCLE 18) 
NOS/VE Peripheral Maintenance and Support 

A4,0 HOD CONSOLE FAILURE REPORTING 



IOU OUTPUT PARITY 

INDETERMINATE OUTPUT PARITY 
f» Cylinder* Track and Sector of media failure (In decimal) 
g* Octal display of general status (last failure status) 
tw Octal display of detailed status (last failure status) 
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Note that if the presentation of unit number* cylinder* track and 
sector in decimal is a problem* the detal led status does contain these 

values in an octal representation* as follows* 

844-4x 1110 9876543210 

word 4 UUUUUUU _<U» unit number) 

5 CCCCCCCCCTTT 

6 T T S S.S S S CCylinder^Track* Sector I 

885-lx 1110 9876543210 

word 4 U U U II U _<U* unit number) 

5 CCCCCC 

6 CCCCTTTTTTTT CCyl inder#Track#Sector ) 

7 SSSSSSSS 
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A5.0 EAILyE£-LOJi£I&£ 



NOS/v*E logs failure data in the ENGINE £RING_LQG. Refer to the 
sections below for specific information on the log antry content* 

Each Item In the ENGXNEERING_LQG Is called a statistic* Information 
follows concerning identification of statistics in this log* 

If problems with mass storage or tape peripherals are suspected* the 

0ISPLAY.BINARY.L06 utility may be used to extract a subset of the 

£MGINEERXNG_LGG pertinent to the source of the problem* depending upon 
the degree of problem isolation already done* 

A good habit for the site to follow is to use DISPLAY.SIHARY^LOG at 
the time that the ENGINEERING_LOG is terminated via the TERMINATE_LOG 
command to list the mass storage and tape statistics for the day* IF an 
intermittent failure should develop* a picture of how the peripheral has 
performed In the recent past nay be invaluable In debugging the problem* 

A5 . 1 5I!IISli£-iaEaIIEi£R 

The configuration management statistics will have •CM* as the 
Identifier* 

A5.2 mmii£-£a&£ 

The configuration management statistics will be identified by the 
codes 350000**359999. 

A5*3 REUIlfltL^fl-QIUtt-SIAllSUCS 

The sfpSeml t.systen.stetl s'tic interface captures some information 
from the emitting job and tests environment and places this In the 
emitted statistic* The Julian date (yyyyddd)* time <fih*mmiss*ms)» job 
name tsystem-suppl led! and global -task— I d (system-supplied) are 
provided* 

At present all the disk-related statistics are emitted from a 
•system* job* Therefore* the job name and global-task-id data are of no 
value* However* the tape-related statistics are emitted from within the 
environment of the job using the tape hardware elements* Therefore one 
«ay use the JM180000 statistic to determine the user name of the Job 
owner and the JM180001 statistic to determine the user-supplied job name 
of the job which emitted tape-related statistics* 
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For example* the following command sequence extracts all the 
•JH180000* entries in the STATISTIC log to the fiie LISTING. Then the 
EDIT.FILE command is used to peruse the output to find a particular 
entry* 

DISPLAY_BINARY_LOG T-STATISTIC 0»LISTING 

DEFINE.GROUP. G»USERJ*AHE S«J Ml 80000 

DUNP_GRQUP S»U$ER_NAHE 

QUIT 

EDIT_FILE LISTING 
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A5*4 SAHPLE PROCEDURES FOR DISPLAYING FAILURE DATA 

A3 . 4 SAm£_£EQ££ayE££.EQ£.aimAnH£-£AILUE£_JQAIA 

The following SCL procedures are provided as an example of how to use 
DISPLAY.BINARY.LOG to obtain failure data. 

A5.4.1 DISPLAY_D2SK_FAILURE_DATA 

PROC display.dlsk_fai iure_data jdlsdfd ( .. 
log* I J fife =$Jocal .$enj ineer in<3_ log; •• 
output*©* file ■ Soutput) 
displeyjblnary.log i»$value( log) o«$value(output) 
deflne_group syste?a_action statlstlc«CN350000 
define_group softnare.f al lure statist ic*CM350001 
define.group $7154_f ai lure stat istlc*CM350002 
define.group $7155.fai lure s tat lstlc»CH350Q03 
dump_group group»syste«i_acti on cf*f n»*4#8)#C 5**7#10)) 
duiRp^group group»sof tware.f ai lure cf» < (1**4*8 )»(5. .8*10) ) 
dump.group group*$7154_f al lure •• 

cf-(Cl.«*j8)#(5..10»10)*(ll»«16*8)* (17»10)# <18**a0#8)) 
dump.group group 3 $7155_fai lure »* 

cf*<<l««4#8)#(5«.10*10)#(ll«.16*8)#U7#10)#<18..60#8)) 

qu i t 

PROCEED di sp I ay.disk.fei lure.data 
A5*4*2 DXSPLAY.TAPE.FAILURE.DATA 

PROC dl sp I ay^tape.fai I ura.data #distfd < .. 
logji* file *=$ local .Senj I neer lng_ log; *• 
outputs o« file * Soutput) 

dlsplay.binary^log l*$valueUog) o*$vaf ue(output) 
define.group group*$7021_f al lure stat istic»CH351O02 
dump.group group*$7021_fai lure •* 

cf*<U.*4* 8), 16**9,10)* { 10* *25#8)#*. 

C26.*28#10)*I29*16)* 130*10) *<31*.62# 8)) 

<iu i t 

PROCENO display.tape.f ai lure_data 
A5.5 QIS&zfi£UI&&-£IAIXm£& 

The statistic codes 350000 ** 350999 will be set aside for disk 
related configuration aianageaent statistics* 

The following codes will be initially defined! 

350000 - System Action* Documents significant events/actions related 
to the disk configuration* 
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01 - Software Failure Data* Documents software failures detected 
by NOS/VE software. 

350002 - 7154 Disk Controller Failure Data. Documents hardware 
failures detected by NQS/VE software* 

350003 - 7155-1 and 7155— lx Disk Controller Failure Data* Documents 
hardware failures detected by NOS/VE software* 

A5*5»l D£SCRIPTIVE_DATA PORTION OF STATISTIC 

The descriptive-data portion of the disk related statistics have the 
following contents* 

f <mf>*<pp>*<channel >.<contro I ier>*<unl t>*<vsn>*<sever I ty>*<symptom> f 

where <mf> is the name of the mainframe specified when the physical 
configuration was Installed* 

where <pp> is the string »PPn» where n Is the PP number in decimal of 
the P? which performed the I /o operation which is being reported* 

where <channel> Is the string *CHANN£Ln f where n is the channel 
number over which the l/o request was processed* 

where <controller> is the element name of the disk controller used in 
the failing request* 

where <unlt> is the element nmB of the failing disk storage device 
used in the failing request* 

where <vsn> is the recorded-vso of the disk volume which was the 
object of the failing request* 

where <severity> is the string *UF* or f RF* for unrecovered and 
recovered failure severity* respectively* 

where <syaptom> is the symptom/action statement provided by the 

system • 

A5*5*2 COUNTERS PORTION OF STATISTIC 

For recovered disk failures the Initial failure data is logged* For 
unrecovered disk failures both the initial and final failure data is 
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logged* 

The COUNTERS portion of the disk-re fated statistics have the 
fo flowing contents* 

Note that bit Cleft-most bit) of the counter word indicates the 

presence or absence of information in the remainder of the word* If bit 

6 is not set* then the contents of the word contain a bonaflde value as 
documented below* 

1* PP number 

2* Channel Number of Controller 

3* Equipment Number of Controller 

4* Physical Unit Number (If action related to a unit) 

5* Unit-type (Identifies the kind <if unit* i.e. product id) 

1 - 844-4x 

2 - 385-lx 

6* Controller-type (identifies the kind of controller) 

1 - 7154 

2 - 7155-lx 

7* System Action Code (tells what the system did) 

1 - CONTROLWARE RELOADED 

2 - CONTROLLER DONNED 

3 - UNIT DOWNED 

A5 • 3« 2 • 2 SnltMl£t-.£jiiii£jS-r-.Miilll 

1* PP number 

2* Channel Number of Controller 

3* Equipment Number of Controller 

V* Physical Unit Number (if failure related to unit) 

5* Unit-type (identifies the kind of unit* 1 *e* product id) 

1 - 844-4x 

2 - 885-lx 

6* Logical Operation Code (tells what the system was trying to do) 
7* Failure Severity 

§ - Recovered Failure 

1 - Unrecovered Fai lure 
8* Failure Symptom Code (tells what the system thinks is wrong) 

1 - Address of PP_Communicatlon_Area not on word boundary* 

2 - Reserved field of the PP_Commun!cat lon.Buf fer descriptor 

is non-zero 

3 - Reserved field of the PP_Request_Queue descriptor Is 

non_zero 

4 - Logical unit number In Unl t.Descr I ptor not in sequence 

or out of range 

5 - Address of Uni t_Intarf ace^Tabl e not on word boundary* 
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A5«5*2*2 Software Failure - 350001 

6 - Uni t.Descrlptor contains invalid channel number 

7 - CommunJcation.Buf fer length not a multiple of words or 

not long enough 

8 - Reserved field after number. of.unl ts component of the 

PP.Intarf ace.Tabl a is non-zero 

9 - Invalid physlcal-unl t-number in Unl t.Descrlptor 

10 - Logical. uni t.number of Un it. Inter f ace.Tabl e not equal 

to value in Uni t.Descrlptor 

11 - A64ress of Unit.Communlcation.Buf f er In 

Unit.Interf ace.Table not on word boundary 

12 - Reserved field of Unlt.Cemmunicat lon.Buffer is non-zero 

13 - Reserved field of Uni t.Request.Oueue descriptor is 

non.zero 

14 - Invalid unit-type in Uni t. Inter face.Table 

15 - Un! t.CoaHaunicatl on.Buf fer length not word multiple 

16 - Unit.Communi cat lon.Buffer length too small 

17 - Invalid secondary address in i/o request header 

18 - Invalid l/o request command code 

19 - Invalid length field In indirect n66r%ss list 

20 - Invalid command sequence 

A3 . 5 * 2 . 3 ZI5i.£iUiii:fi-::-3500£2 

1. PP number 

2* Channel Number of Controller 

3. Equipment Number of Controller 

4* Physical Unit Number lif failure related to unit} 

5. Unit-type (Identifies the kind of unit* !•«• product Id) 

1 - 844-4x 

2 - 885-lx (7155 control ler only) 

6. Logical Operation Code Ctells what the system was trying to do) 

1 - read 

2 - wr i te 

3 - mr i te.fnitlal Ize (sets unwritten areas to preset.value) 

4 - read.f 1 aw.mip 

5 - dlsts.dr Ivar. Initial i zation 
7« Failure Severity 

- Recovered Failure 

1 - Unrecovered Failure 

8» Failure Symptom Code Ctells what the system thinks Is wrong) 

1 - INDETERMINATE (channel or controller orunlt) 

2 - INPUT CHANNEL PARITY - On an input from controller to 9P 

the channel-error-flag was set. 

3 - OUTPUT CHANNEL PARITY - On an output from 9P to controller 

the controller reported a parity error in detailed status 
but the channel-error-flag was not set» 

4 - CONTROLLER FAILURE - (reported by controller) 

5 - UNIT FAILURE 

6 - FUNCTION TIHEOUT - (controller not responding) 
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A5. 5*2*3 7154 Failure - 350002 

7 - UNIT RESERVED - (unit reserved to opposite access) 

During i/o request processing the PP driver attempts 

to connect to the target unit* If it cannot connect 

to the unit* this statistic is generated* The driver will 

terminate the i/o request as a result* 

8 - CONTROLLER RESERVED - (to another channel) 

During i/o request processing the 99 driver attempts 
to obtain the coupler reservation* If not successful for 
10 seconds* this statistic Is generated* The driver will 
continue to try to obtain the coupler reservation until 
successful • 

9 - SEEK FAILURE 

10 - ERROR IN CHECKWORD 

11 - CONTROLLER RAM PARITY 

12 - INCOHPLETE SECTOR TRANSFER 

15 - UNIT NOT READY - START switch off* unit not spun up or 

dropped ready 

16 - UNIT OFFLINE OR NOT CABLED - 844 unit has switch on hack 

of unit in offline position or unit not cabled 
to controller. 

17 - UNIT READ ONLY SWITCH ON - 885 unit has wr ite-lnhi bi t 

switch set 

18 - CHAN ENABLE SWITCH OFF/UNIT NOT CABLED - 885 unit has 

CHAN ENABLE switch off or unit Is not cabled to controller 

19 - FLAWED TRACK - a sector with a track flaw bit set 

has been read/written* This way indicate that the Utility 
Hap is wrong or there Is a NOS/VE software problem* 

20 - FLAWED SECTOR - a flawed sector on an 844 unit has been 

read/wr I tten* This may indicate that the Utility NAP Is 
wrong or there is a NOS/VE software problem* 

21 - SECTOR ADDRESS HISCOMPARE 

22 - CYLINDER ADDRESS HISCONPASE 

23 - LOST CONTROL WORD 

24 - 100 OUTPUT PARITY - On an output from 99 to controller 

both the channel-error-flag and the controller's detailed 

status Indicated a parity error occurred* 
Z5 - INDETERMINATE OUTPUT PARITY - On an output from 9? to 

controller the channel-error-f lag was set but there was no 

error reported by the controller* This way mean there is a 

problem In the IOU and/or the channel and/or the controller* 
9* Request Retry Count 

The number of times the 99 driver retried the i/o request 

from the beginning* 
10* Sector Retry Count 

The number of retries that the PP driver performed on the 

failing sector on the last attempt to retry the i/o 

request* 
11* Cylinder number of initial seek 
12* Track number of initial seek 
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A5.5*2.3 7154 Failure - 350002 

13* Sector number of initial seek 

14. Cylinder number of failure 

15* Track number of failure 

16* Sector number of failure 

17* Residual byte count on incomplete channel transfer 

18* F«i I ing Function 

The function that caused the Initial recovery attempt* 
The value is extracted from the initial detailed status if 
the controller provides status after the failure* On a 
function timeout* the function reported is the one which 
Has outstanding when the control ier hung* 

19* General Status of Initial Failure 

20* Detailed Status of Initial Failure- Word 1 



39* Detailed Status of Initial Failure- Word 20 

The following counter words are only present for unrecovered 
disk failures* They represent the status from the last 
unsuccessful attempt at recovery. 

4§» General Status of Last Fal lure 

41* Detailed Status of Last Failure - Word 1 



60* Detailed Status of Last Failure - yord 20 

A5.5*2.4 ZH2zla-£aila££-=-!SfMa§2 

Refer to 7154 for specific content* 

A5.6 IA££=££LiIEi_mmiI£S 

The statistic codes 351000 *• 351999 Mill be set aside for tape related 

configuration management statistics* 

The following codes will be initially defined* 

351000 - System Action* Documents significant events/actions related 
to the tape configuration* This ni 1 1 be supported in NOS/VE Rl*l* 

351002 - 7021-3x Tape Controller Failure Data* Documents hardware 
failures detected by NOS/VE software. 

The statistics defined above have the following general format* 
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A5.6.X DESCRIPTIVE_DATA PORTION OF STATISTIC 

The descriptive-data portion of the tape related statistics have the 
following contents J 

f <«tf >*<pp>*<ehannel>*<control ler>*<uni t>*<vsn>*<severi <ty>*<sy«pto»>* 

mhnr& <mf> is the name of the mainframe specified when the physical 
configuration was Installed. 

where <pp> is the string *PPn f where n is the 9? number In decimal of 
the PP which performed the i/o operation which Is being reported* 

where <ehannel> is the string •CHANNELn* where n is the channel 
number over which the l/o request was processed* 

where <controlier> is the element name of the tape controller used In 
the failing request* 

where <unit> is tha element name of the falling tape storage device 
used in the failing request* 

where <vsn> is the external-vsn of the tape volume which was the 
object of the falling request* 

where <severity> is the string •UF* or •RF' for unrecovered and 
recovered failure sever ity# respectively* 

where <symptom> is the symptom/action statement provided by the 
system* 

A5.6.2 COUNTERS PORTION OF STATISTIC 

In NOS/VE Rl*0«2» only the last failure encountered during an 

unrecovered i/o operation will be logged* In NOS/VE Rl*0*3# the format 

.of the following statistic will change to report the initial failure 

data for recovered failures and both the Initial and final failure data 

for unrecovered failures* 

The Historical and Current 8lock_Id Windows are only appended if the 
Failure Symptom Code is »TAPE HEDIUH FAILURE 1 . 

The general format of the COUNTERS portion of the statistic is as 
fol lows t 

Note that bit (left-most bit I of the counter word indicates the 
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presence or absence of information In the remainder of the word. If bit 
Is not sett then the contents of the word contain a bonaflde value as 
documented below. 

1. 99 number 

2. Channel Number of Controller 
3« Equipment Number of Controller 

4» Physical Unit Number (If failure related to unit! 

5. Unit-type (identifies the kind of unit* 1 #e# product id) 

1 - 679-2 

2 - 679-3 

3 - 679-4 

4 - 679-5 

5 - 679-6 

6 - 679-7 

6* Logical Operation Code (tells what the system was trying to do) 

I - read 
Z - write 

3 — rewind 

4 - unload 

5 - clear_reserve 

6 - wr I te_tapemark 

7 - data_secur ity_erase 

8 - forespace 

9 - backspace 

10 - forespace_tape»ark(s) 

II - backspace_tapemark( s) 

12 - get^status 

13 - TCU^loopback 

14 - Unl t_loopback_I 

15 - Unit_loopback_II 
7» Failure Severity 

- Recovered Failure 

1 - Unrecoverad Failure 

8« Failure Symptom Code (tells what the system thinks is wrong) 

1 - INDETERMINATE (channel or controller or unltl 

2 - INPUT CHANNEL PARITY - On an input from controller to 99 

the channel-error-flag was set* 

3 - OUTPUT CHANNEL PARITY - On an output from 99 to controller 

the controller reported a parity error In detailed status 
but the channel-error-flag was not set. 

4 - CONTROLLER FAILURE - (reported by controller) 

5 - UNIT FAILURE 

6 - FUNCTION TIMEOUT - (controller not responding) 

7 - UNIT RESERVED - (unit r%$%tv%$ to opposite access) 

13 - TAPE MEDIUM FAILURE 

14 - ERASE LIMIT EXCEEDED 
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24 - IOU OUTPUT PARITY - On an output from ?? to controller 
both the channel-err or-f I as and the control ler f s detailed 
status Indicated a parity error occurred* 
23 --INDETERMINATE OUTPUT PARITY - On an output from PP to 

controller the channel-error-f lag Mas set but there was no 
error reported by the controller* This may mean there is a 
problem in the IOU and/or the channel and/or the controller* 

9* Retry Count i tells how many times the driver performed retry) 

10. General Status - Word 1 

11* General Status - Word 2 

12* Detai led Status - Word 3 



25. Detailed Status - Word 16 

26* Slock Count From Beginning of Tape - This Indicates the 

displacement from the beginning of the tape at the time 

the failure occurred* 
27* Total Blocks Read - This indicates the total number of blocks 

read by a job since the tape volume was mounted on this 

tape transport* 
28* Total Blocks Written - This indicates the total number of blocks 

written by a Job since the tape volume was mounted on this 

tape transport* 
29* Requested Format {Describes options selected by driver) 
30* Density of Tape Used 
31. Historical Block-id Window - Word 1 (latest) 



46. Historical Block-id Window - Word 16 Coldest) 
4?* Current Block-id Window - Word 1 (latest) 



62* Current Block-Id Window - Word 16 (oldest) 
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A7*0 aiCOMEifiUEAIIOti 

A7.1 AttUfiEXIflUS 

1* The reader is already f ami liar with the NOS/VE installation and 
deadstart process but is not familiar with what to do in 
particular failure situations* 

2* The systen analyst will look at the HDD display for failure 
Information In the event of a system failure* If the system has 
not failed out peripheral failures are suspected* the system 
analyst will look at the Engineering Log for failure information* 

3* The site has generated a deadstart tape with the specified 
Physical and logical configurations as depicted below* Unless 
otherwise specified* assume the site has installed NOS/VE* has 
been running the system* has permanent files on disk and has 
backup tapes of the permanent files* 

*7 .2 £MLU£££ JiaX_££maiM£.E£££g£l£y£m2M 

If the performance of the system is degrading and there is an HDD 
console* see If unrecovered disk faiiure(s) have been reported* 
Alternatively* use the DISPLAY.BINARY.LQG command to determine whether 
unrecovered disk/tape failures have been reported In the Engineering 
Log* 

The first alternative to consider when a peripheral failure is 
suspected Is to terminate NOS/VE (if still running) and revert to NQS 
<single-5tate execution)* When NQS/VE is terminated* all devices remain 
DOWN in the NQS configuration* Therefore HALET may be used on NOS to 
isolate %nd repair peripheral hardware problems* If the problem Is a 
hardware logic failure and is repaired* one should be able to perform a 
continuation deadstart and resume normal operation* If this alternative 
is not chosen and the failing element is the system deadstart controller 
or disk drive* any modified data In NOS/VE real memory at the time of 
the failure will be lost* 

If repair will take too long or files will be lost as a result of the 
failure* the discussion below is pertinent* 

A7 * 3 £QM£lSySAIH2M.Jl-r^I^£l£.IIQMI0LL£E 

Note that the disk and tape units are only accessible from one 
controller* This is not a recommended configuration from the 
standpoints of fault tolerance and system performance* Compare the 
fol lowing scenarios with those of configuraton #2* 

channel channel 2 channel 6 
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A?. 3.1 DISK RECONFIGURATION SCENARIOS 



Listed below are scenarios for possible disk failures which require a 
NOS/VE deadstart or which occur while deadstartlng NOS/VE* Assume that 



change the configuration 
In the discussion below a 
disk drlvei failures such 
be recorded improperly or 



i f a I lure 
no spare 
continue 



in each case the desired recovery action Is to 

and resume operations as soon as possible* 

•bad HOA* refers to the disk pack mounted on a 

as head-crash or a bad head may cause data to 

to be Incapable of being read* 

1* Assume 1) a bad HOA on disk #1 (not system device) or 2) i 
In disk drive #1 which will take too long to repair and 
disk drive* The desired result is to delete disk #1 and 
degraded operation with only 1 disk (#0) on channel #0* 

a* Rebuild the NOS/VE deadstart tape with a new configuration 
prolog* The new prolog should have the failing device in 
the physical configuration but not in the logical 
conf iguration, i *e* the INSTALL_LQGICAL_C0NFIGURA7I0N 
subcommand of the LQGICAL_CQNFIGURATIGN,JJTILITY (LCU) should 
•exclude* the falling element* In addition the 
configuration prolog may need to be changed if It was set up 
to INITIALIZE_H$_VOLUHE and ADD_V0LUME_T0_3ET for the 
failing element;,! these subcommands must be deleted* 
Perform an 9 installation deadstart* of NOS/VE* 
Reload permanent files* Since you now have only 3 disks* 
you may need to reload f i les for a subset of the users and 
tell the rest of your users to wait for the fourth disk to 
be repaired* 

Resume operation In a degraded mode* 

When the failing disk has bem repaired* execute* tb^ LCU to 
re-lnstail the logical configuration to * include 1 the 
repaired element* Note that the newly Installed logical 
configuration will not become active until the next 
continuation deadstart* 

When convenient do a TERN IN ATE_ SYSTEM and then a 
continuation deadstart* This will activate the logical 
configuration installed above* 



b* 
c. 



d. 
e* 



f. 
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g* Execute the LCU to INITIALIZE^HS.VOLUHE and 

ADD_VOLUME_TG„SET for the repaired element, 
h* Reload any permanent files not previously reloaded* 
i* Continue with normal system operation* 
2* Assume 1) a bad HDA on disk #0 (system device! or 2) a failure In 
disk drive #0 which nil I take too long to repair and no spare disk 
drive* The desired result Is to delete disk #0 and continue 
degraded operation with only 1 disk (#11 on channel #0* 

a* Rebuild the NOS/VE deadstart tape on the NOS system* The 

SET_D£AOSTART_DEVICE system-core command must be changed to 

reflect the type of unit and the unit-number 11) for the new 

system disk* The configuration prolog must also be rebuilt* 

The nan prolog should have the failing device (0) in the 

Physical configuration but not in the logical configuration* 

i*e. the INSTALL_LOG ICAL.CONFIGURATION subcommand of the 

LCU should 'exclude* the failing element* In addition the 

configuration prolog may need to be changed if It Mas set up 

to INXTXALIZE.HS.VOLUHE and A0D_VOLUHE_TG_SET for the new 

system device; these subcommands must be deleted* 

b* Perform an 'Installation deadstart' of NOS/VE* 

c* Reload permanent files* Since you now have only 3 disks* 

you may need to reload files for a subset of tha users and 

tell the rest of your users to wait for the fourth disk to 

be repaired* 

d* yhen the failing disk has been repaired* execute the LCU to 

re-install the logical configuration to •Include 1 the 

repaired element* BNote that the newly installed logical 

configuration will not become active until the next 

continuation deadstart* 

a* Mhen convenient do a TERMINATE_StSTEH and then a 

continuation deadstart* This will activate the logical 

configuration installed above* 

f. Execute the LCU to XNTXTIALIZEJ1S_V0LUHE and 

A0D_VOLUflE_TO_SET for the repaired element* 
g* Raload any permanent files not previously reloaded* 
h* Continue with normal system operation* 
3* Assume 1) a bad HDA on disk #3 (not system device) or 2) a failure 
in disk drive #3 which will take too long to repair and no spare 
disk drive* The desired result Is to delete disk #3 and continue 
degraded operation with only 1 disk (#41 on channel #2* 

a* Rebuild the NOS/VE deadstart tape on the NOS system* The 
configuration prolog will need to be changed* The new 
prolog should have the failing device in the physical 
configuration but not In the logical configuration* I.e. 
the INSTALL..LQGICAL.CONFIGURATICN subcommand of the 
LGGICAL_CGNFIGURATIGN_UTItITY (LCU) should •exclude* the 
failing element* In addition the initialization prolog may 
n^Bd to be changed if It was set up to INITXALXZE_H$_VOLUME 
and ADD_VOLU?!E_TQ_SET for the failing device! these 
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subcommands must be deleted* 

b» Perform an 'installation deadstart* of NOS/VE 

c. Reioad permanent files* Since you now have only 3 disks* 
you may need to reload files for a subset of the users and 
tell the rest of your users to Malt for the fourth disk to 
be repaired* 

d* yhen the failing disk has been repaired* execute the LCU to 
•include 1 the failing element In the installed logical 
configuration* Note that the newly installed logical 
configuration will not become active until the next 
continuation deadstart* 

e* yhen convenient do a TERHINATE^SYSTEH and then a 
continuation deadstart* This will activate the logical 
configuration installed above* 

f. Execute the LCU to INITIALIZE.NS.VOLUNE and 
ADO.VaLUHE.TO.SET for the repaired element* 

g* Reload any permanent flies not previously reloaded* 

h* Continue with normal system operation* 
4* Assume the controller on channel #0 requires repair and that the 
repair will take too long* The desired result Is to delete the 
failing controller from the configuration and continue degraded 
operation with the single controller on channel #2* 

a* Have a Customer Engineer recable units and 1 to the 
controller on channel 2* 

b* Rebuild the NOS/VE deadstart tape on the NOS system* A new 
configuration prolog Is required* The new prolog should 
show units and 1 being connected to the controller on 
channel 2* The configuration prolog should also be changed 
to •exclude' channel from the installed logical 
configuration* The SET_DEADSTART_CONTROLLER system-core 
command may need to be changed if the controller on channel 
#2 has a different product_l dentif Icati on than the one on 
channel #0* 

c* Do a SETVE to change the deadstart channel number from $ to 
2. 

d* Perform an •installation deadstart* of NOS/VE* 

e* Reload permanent files* 

f« Continue degraded system operation* 

g* yhen the failing controller has been repaired* use the 
INSTALLJ*HYSICAL_CGNFISURATION subcommand of the 
PHYSICAL_CGMFIGURATIONJJTILITY to re-install the original 
physical configuration* Note that the newly Installed 
physical configuration will not become active until the next 
continuation deadstart* 

h* m%n convenient do a TERHINAT£_SY$TEH* Recabling cannot 
occur while the NOS/VE system Is executing* 

i* Recable to match the installed physical configuration* 

j* Perform a continuation deadstart* 

k* Continue with normal system operation* 
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5* Assume the controller on channel #2 requires repair and the repair 
will take too long* The desired result is to delete the falling 
controller from the configuration and continue with the remaining 
controller on channel #0« 

a* Have a Customer Engineer re cable units 3 and 4 to the 

controller on channel #0* 
b* Rebuild the NOS/VE deadstart tape on the NOS system* A new 
configuration prolog Is required* The new prolog should 
show units 3 and 4 being connected to the controller on 
channel #0* The configuration prolog should also be changed 
to f exclude* channel Z from the installed logical 
configuration* 
c* Perform an 'Installation deadstart 1 of NOS/VE. 
d* Reload permanent files* 
e* Continue degraded system operation* 

f. yhen the failing controller has hm%n repaired* use the 
INSTALL.PHYSICAL.CONFISURATION subcommand of the 
PHY$ICAL_CONFIGURATIONJJTILITY to re-Install the original 
Physical configuration* Note that the newly installed 
physical configuration does not become active until the next 
continuation deadstart* 
g* When convenient do a TERNINATE_SYSTEN* Recabllng cannot 

occur while the NOS/VE system is executing* 
h* Recable to match the installed physical configuration* 
i* Perform a continuation deadstart* This will activate the 

physical configuration installed above* 
j. Continue with normal system operation* 
6* Assume 1) the HOA on disk #1 Cnot system device) Is not damaged 
Bn4 2) the failure in disk drive #1 will take too long to repair 
and 3) a spare disk drive* The desired result Is to delete the 
failing device* to move the disk pack from the falling drive to 
the spare drive* and to continue normal operation* 

a* This assumes that a spare disk drive has been physically 
configured and that the disk pack CHDA) normally mounted on 
the drive is not currently used by NOS/VE* i*e* the disk 
drive is defined in the installed physical configuration but 
not In the installed logical configuration* If these 
assumptions are not valid* then follow one of the earlier 
scenarios concerning a failing disk drive* 
b* Remove the disk pack IHQAJ frost drive #1 and mount it on the 

spare 4ri^m* 
c* Perform a continuation deadstart and request operator 

intervention* 
d* From within the LCU use the IMSTALL.LOGICAL.CONFIGURATIGN 
subcommand to f exclude f drive #1 and f include 1 the spare 
drive* 
a* Continue normal system operation* 
?• Assume 1) the HDA on disk #0 I system device! is not damaged and 2) 
the failure Is in disk drive #0 which will take too long to repair 

- CGHPANY PRIVATE - 



A7-6 
SOFTWARE RELEASE BULLETIN 

84/03/12 
NOS/VE (CYCLE 18) 
NOS/VE Peripheral Halntenance and Support 

A7*0 RECONFIGURATION 

A7.3.1 DISK RECONFIGURATION SCENARIOS 

and 3) a spare disk drive* The desired resuit is to delete the 
failing device* to wove the disk pack CHDA) from the failing 
device to the spare device and to continue normal operation* Note 
that 885-lx <FNO) HOAs can be removed by a C£ and moved to a spare 
drive* Operators can move 844-4x drives themselves* 

a* This assumes that a spare disk drive has been physically 
configured and that the HDA normally mounted on the storage 
device is not currently used by NOS/VE* i*e* the disk drive 
is defined in the installed physical configuration but not 
In the installed logical configuration* If these 
assumptions are not valid* then follow one of the earlier 
scenarios concerning a falling disk storage element* 

b* Remove the disk pack (HDA) from drive #0 and mount the pack 
on the spare drive* 

c. If the disk pack was moved to channel #2 use the SETVE 
command to change the deadstart channel from to 2* 

d* Perform a continuation deadstart and request operator 
intervention* 

e* If necessary change the SETJGEA0START W CONTROLLER system-core 
command to specify the product-identification of the 
control ler* 

f* Change the SET^OEADSTART.DEVICE system-core command to 
identify the unit number of the spare drive* 

g. From within the LCU use the INSTALL_LGGICAL.CONFIGURATIGN 
subcommand to 'exclude* drive #0 and * include* the spare 
dr i ve* 

h* Continue normal system operation* 

A7*3*2 TAPE RECONFIGURATION SCENARIOS 

Listed below are scenarios for possible hardware failures which may 
occur (or be detected) white using tape peripherals as configured in 
configuration fl« 

a* Assume a failure in the tape controller has caused a NGS/VE 

interruption* The desired result is to remove the failing tape 

controller from the NOS/VE configuration to allow diagnosis and 

repair to. occur in the NOS state concurrent with NOS/VE execution* 

a* Perform a continuation deadstart and request operator 

intervention* 
b* From within the LCU* re-instal I the logical configuration 

and 'exclude* channel 6* 
c» Continue operation without the tape controller* 
d* yhen the tape controller has been repaired* execute the LCU 
to re-install the logical configuration and •include* 
channel #6* Note that the newly installed logical 
configuration will not become active until the next 
continuation deadstart* 
e* When convenient do a TERMINATE_$YST£N and perform a 
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continuation deadstart to activate the newly installed 
logical configuration* 
f • Continue with normal operation* 
fo* Assume a failure in the tape controller which does not cause a 
NOS/VE interruption* The 4€slr%<i result is to remove the failing 
controller from the NOS/VE configuration to allow diagnosis and 
repair of the element to occur in the NOS state concurrent with 
NOS/VE execution. 

a* Execute the LCU to re-install the logical configuration and 

9 exclude* channel #6. Note that the newly installed logical 

configuration does not become effective until the next 

continuation deadstart* 

b* When convenient do a TERNINATE_SYSTEH and perform a 

continuation deadstart* 
c* Continue operation without the tape controller* 
d* When the tape controller has been repaired* repeat the 
process above to •include* channel #6* 
c* Assume that tape unit #40 has failed* Also assume that this 
failure has not caused a NOS/VE Interruption* The desired result 
is to replace unit #40 with a different tape unit from the NOS 
configuration* use the NOS state for diagnosis and repair of the 
failing element and continue NOS/VE execution* 

a* Use the PCU to re-install the physical configuration 
omitting the failing tape unit and adding the replacement 
tape unit* Note that the newly installed physical 
configuration will not become active until the next 
continuation deadstart* 
b* Use the LCU to re-Install the logical configuration* Note 
this is necessary because the LCU captures some of the 
Information in the Installed physical configuration which 
changed above* 
c. When convenient do a TERHINATE.SYSTEH and a continuation 

deadstart* 
d* Continue with normal system operation* 
d* Assume that tape unit #49 has failed and the failure caused a 
NOS/VE interruption* The desired result is to replace unit #40 
with a different tape unit from the NOS configuration* use the NOS 
state for diagnosis and repair of the failing element and continue 
NOS/VE execution* 

a* Perform a continuation deadstart* 

b* After deadstart run the PCU to install a new physical 
configuration which omits the failing tape unit and defines 
the replacement* 
c* Oo a TERBINATE_SYSYEN and perform another continuation 
deadstart to activate the newly installed physical 
configuration* 
d* Continue normal system operation* 
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Listed below are sentries for possible hardware failures that may 
require a NOS/VE deadstart or may occur while performing a NOS/VE 
deadstart* The following scenarios can also be applied to the case 
where the failure did not cause a NOS/VE interruption* In this case one 
can execute the LCU to •exclude 1 a falling controller* do a 
TERMINATE.SYSTEM when convenient and then follow the steps below 
omitting the operator intervention and consequent LCU execution* 

A7.4.1 DISK RECONFIGURATION SCENARIOS 

The following describes the recommended approach for dealing with the 
failure of one of the two disk controllers in configuration #2 above* 
1. Assume the site has configured to channel #0 unit #0 for the 
deadstart device and the controller on channel #0 fails* The 
desired resuKt is to return the controller to the NOS state for 
diagnosis and repair and to continue degraded operation minus the 
f ail ing control ler* 

a* Execute SETVE command to change the deadstart channel number 

from- § to 1* 
b* Perform a continuation deadstart and request operator 
Intervention. 
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c* Change the SET_DEADSTART_C0NTR3LLER system-core command if 
the produet_identlf icatlon of the controller on channel #1 
is different than that of the controller on channel #0* 

d. From within the LCU use the INSTALL_L0GICAL_CGNFIGURATI0N 
subcommand to 'exclude 1 channel #0* 

e* Continue degraded system operation* 

f* When the failing controller has been repaired* use the LCU 
to re-install the logical configuration and 'include* 
channel #0* Note that the newly installed logical 
configuration ^lll not become active until the next 
continuation deadstart* 

g* When convenient do a TERNINATE_SYSTEN and perform a 
continuation deadstart to activate the newly installed 
logical configuration* 

h* Continue normal system operation* 
2* Assume the controller on channel #1 fails* The desired result Is 
to return the failing controller to the NOS configuration for 
diagnosis and repair and to continue with degraded system 
operation minus the failing controller* 

a* Perform a continuation deadstart and ask for operator 
intervention* 

b* From within the LCU use the INSTALL_LQGICAL_CONFIGURATIGN 
subcommand to 'exclude* channel #1* 

c* Continue degraded system operation* 

d. When the failing controller has been repaired* use the LCU 
to re-install the logical configuration and ' Include' 
channel #1* Note that the newly Installed logical 
configuration will not become active until the next 
continuation deadstart* 

e. When convenient do a TERHINATi_SYSTEfc and perform a 
continuation deadstart to activate the newly installed 
logical configuration* 

A?*4*2 TAPE RECONFIGURATION SCENARIOS 

The following is the recommended approach for dealing with the 
failure of one of two tape controllers in configuration #2 above* 

1* Assume one of the controllers on either channel #2 or channel #3 
fails* The desired result is to return the failing tape 
controller to the NOS state for diagnosis and repair and to 
continue degraded operation minus the falling controller* 

a* Perform a continuation deadstart and ask for operator 

intervention* 
b. From within the LCU use the lNSTALL_LOGICAL_CGNf IGURATION 
subcommand to 'exclude* the channel with the failing 
control ler. 
c* When . th^ failing controller has been repaired* use the LCU 
to re-Install the logical configuration and 'include* the 
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channel with the failing controller. Note that the newly 
installed logical configuration will not become active until 
the next continuation deadstart* 
d. When convenient do a TERMINATE.SYSTEH and perform a 
continuation deads tart to activate the newly installed 
logical configuration. 
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Bl . £££13Att£ftI_EXLE_gMM£ll£MI 
81. 1 flAfiltU£-£E8i!AllEI!I-ElL£-i-aAC££ 

The purpose of this command Is to initiate execution of the 
BACKUP.PERHANEMT.FILE command utility. This utility creates backup 
copies of permanent files and catalogs* All catalog information (e.g. 
file descriptions* access control lists* usage log) and file contents 
are copied. The RESTOREJ > ERHAN£NT_FILE utility restores files and 
catalogs from their backup copy* 

In general* use of the utility Is according to the same access rules 
es other Permanent File Hanagement commands* Users can only backup 
files for which they are permitted an access_mcde that includes reed and 
a share_mode that does not include (append* shorten or modify)* The 
System Operator can backup all files regardless of access permission* A 
backup Mill not be done for files that are busy* If a file is busy the 
file Mil) be skipped* A file is busy if access_mode of (read) and 
share.mode of (read* execute) cannot be obtained. This means that 
exclusive access of append* shorten and modify must be obtained* 

Files that have been accessed with an Implicit attach prior to a 
backup may be still attached in a mode that causes the file to be 
skipped* A implicitly attached file should be explicitly detached or 
the user should logout and login to insure that none of the files are 
busy that are to be backed up* 

In general if errors occur on a subcommand* (such as file busy) a 
warning message Is returned to the user* The user should Inspect the 
list file to determine what errors have occurred* 

Utility subcommands ^r^ used to direct the backup operation* 
Capabilities include backup of specific file cycles! backup of ail 
cycles for a file* backup of all files ^n4 catalogs under a given 
catalog; backup of all files and catalogs on the system* 

Utility subcommands are provided to allow the installation to do a 
partial backup of the permanent file base* A partial backup allows the 
installation to only backup dally files that have been modified on that 
day* or since the last full backup* 

Utility subcommands are provided to allow the installation to backup 
a subset of ail the users. This allows the backup of the permanent file 
base to be divided into a serveral sets of magnetic tapes* This also 
allows concurrent backup to occur to more then one tape device* 

Utility subcommands are provided to allow the system operator to 
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decrease the 
of files* 



size of the permanent file base by backup and/or deletion 



Backup commands that use magnetic tape may not executed as part of 
the system console job because of conflicts In tape assignment* 

backup.permanent.fi le backup.fi le*<f I le> 

Clist«<file refer ence>1 
£status*<status varlabie>3 



backup.fi le • bf* This parameter specifies the file to which backup 
Information will be copied* Backup information resulting from 
each subcommand issued during this instance of utility 
execution Is copied to this file* It is initially positioned 
to beg J nn i tig -of - i n for mat I on * 

list I I* This parameter specifies the file to which a summary of 
the results of executing the backup utility are written* This 
Includes a list of the names of all catalogs and files for 
which a backup copy was produced* Omission will cause SLIST 
to be used* The content of the list file may be specified 
using the SET.IIST.OPTIOMS subcommand prior to the backup 
subcommand* If the SET.ilST.OPTIQNS subcommand is ommitted 
then modification date and time* and size will be displayed* 

status? See ERROR HANDLIHG* 

Bl * 2 aAC!iy£-EIEI14ti£liI«£IL£.yiIlIIX«Syfi£QaM4105 

The following subcommands are processed by the BACKUP.PERHANENT.FItE 
utility. 

81*2*1 8ACKUP.AIL.FILES I BACAF 



The purpose of this subcommand Is to create a complete backup copy of 
every catalog and permanent file defined in a NOS/VE system* The file 
specified in the BACKUP.PERHANENT.FILE command to contain the backup 
information must be associated with magnetic tape* Only a system 
operator can perform this function* 

A previous IHCLUDE.USERS directive may be used to select a subrange 
of users* 

kny catalog* file* or cycle specified on a previous EXCLU0E.CATAIOG * 
EXCLUDE.FZLE* or EXCiUDE.HIGHEST.CYClES directive is not backed up* 

Previous IHCIUOE.CYCLES commands may be used to create a partial 
backup* A partial backup includes all catalog information and all 
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permanent file cycle data modified after the date specified on the 
INCLUDE.CYCLES subcommand* The catalog data is used during a restore to 
select file cycle data from previous parti ai or full backup operations* 

Pr ev i ous INCLUDE.CYCLES* INCLUOE.VOLUMESj INCLUOE.LARGE.CYCLES* 
EXeLUDE.HIGHEST.CYCLES. and INCLUDE.EHRTY.CATALOGS along with subsequent 
OELETE.ALL. FILES subcommands may be used to reduce the files maintained 
online* 

backup.ali.fi I es Cstatus*<status variable>] 

statust See ERROR HANDLING* 

Example* to backup all files* Note that the commands submit a Job to 
avoid console conflicts with tape assignment* 

job backup 

request. magnet ictape flle*backup evsn*C f 8ACK1** f BACK2 f ) *• 

rlng»on t«mt9$625<l 
backup.permanent.fi les backup.f I le»backup 

backup. al l.f I les 
quit 
jobend 

81. 2. 2 SACKUP.CATALOG 3 8ACC 

This subcommand is intended to be used by the user* The purpose of 
this subcommand is to create a backup copy of each file cycle and 
catalog registered relative to a specified catalog* Starting at the 
specified catalog the complete catalog hierarchy Is followed to obtain a 
backup copy of each file and Its associated catalog information* 

A system operator is permitted access to all files in a catalog* The 
owner of the specified catalog and a alternate user may obtain a backup 
for ail files (and associated catalogs) to which they are permitted read 
access and not required to share the file for Tmcdify. shorten* or 
9ppen4) • The system operator or the owner of a catalog may backup a 
file which contains a password* 

The utility skips a file cycle If It is busy* that Is If it cannot 
access the file with an access mode of read and a share mode of (read* 
execute}* Exclusive access of Cmodlf y»shor ten and append) is required* 

Previous EXCLUDE.CATALOG and EXCLUDE.FILE commands allow the user to 
exclude catalogs and files from the backup* 

INCLUDE.CYCLES* IHCLUOE.VOHJMES. INCLUDE.LARGE.CYCLES and 
EXCLUOE.HIGHEST.CYCLES subcommands if executed previous to this 
subcommand* may have an undesirable effect on the command* 
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backup.catalog cat al og»<cata I og> 

Cstatus*<status variabie>l 

catalog * c* This parameter specifies the catalog to be backed up* 
This parameter Is required* 

statust See ERROR HANDLING* 

For example* For a user to backup all files 

request_magnetlctape flle~backup rlng*on evsn af HYDUHP* 
backup.parmanent.f i la backup.fi ie*backup fist*cutput 
backup.catalog catalog*$user 

quit 

81.2*3 8ACKUP.FXLE 5 BACF 

This subcommand Is intended to be used by a user* The purpose of 
this subcommand is to create a backup copy of a specified permanent 
file. If the file name includes a cycle reference only that cycle is 
copied. If a cycle reference is omitted all cycles of the file are 
copied. The backup is only done If the user making the request has been 
permitted read access to the file and not required to share for (modify* 
shorten* or append). 

A permanent file cycle Mill be skipped if it Is busy* that is if it 
cannot be accessed with a access.mode of (read) and a share.mode of 
(read* execute). Notes exclusive access for (modify, shorten* and 
append) • 

A EXCLUDE.FXLE subcommand specifying a cycle number when executed 
previous to this subcommand may be used to exclude specific cycles from 
the backup. 

INCLUDE.CYCLES* INCLU0£_VOWHES# INCLUOE.LARGE.CYCL ES and 
EXCLUDEJtttGHEST.CYCLES subcommands if executed previous to this 
subcommand* may have a undesirable effect on the subcommand. 

backup.fi !• flle*<fiie> 

Epassword»<name>l 
£status*<status variableXJ 

file J f* This parameter specifies the permanent file or permanent 
file cycle for anion a backup copy of each cycle Is to be 
obtained* 

password 1 pw* This parameter specifies the file password. It must 
match the password saved for the file. Omission will cause no 
password to be used* 
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status! See ERROR HANDLING. 
Bl.2.4 DELETE.ALL^FILES 

The purpose of this subcommand 1s to delete every permanent file 
created In a NOS/VE system. Previous IMCLUDE^USERS* EXCLUDE.CATALGG* 
EXCLUDE.FILS* INCLU0£_LARGE_CYCLES* INCLUD£_VGLUWES* 

EXCLUOE_HIGHEST_CYCLES» and INCLUDE.CYCLES* subcommands may be used to 
specify a subset of the permanent files to delete. This subcommand may 
only performed by the system operator* 

Empty catalogs may also be deleted depending upon previous 
IHCLUDE^EHPTY.CATALOGS subcommand. 

This command is intended to be used following a 8ACKUP.ALL.FILES 
subcommand to reduce the size of the permanent file base. The listing 
generated by the BACKUP_ALL„FILES subcommand should be reviewed to 
Insure that the files selected could be backed up before executing the 
DELETE^ALL^FILES subcommand. 

The file will not be deleted if acess_mode of (read) and a share.mode 
of (ready execute) cannot be obtained. This means exclusive access for 
(modify* shorten* and append) Is required. The intent of this checking 
is to insure that a file cannot be deleted that could not be backed up 
by a previous BACKUP_ALL_FILES subcommand. If these operations are 
performed in a busy system* changes in file access may result in files 
being deleted that have not been previously backed up. 

de lateral l_f iles tstatus«<status_var I able>J 

status? See ERROR HANDLING. 

81,2.3 DELETE.CATALQG.COHTEHTS 1 DELETE.CATALQG.COHTEHT J DELCC 

The purpose of this subcommand is to delete all files in a catalog. 

This command Is intended to be used by the user. Only the owner of a 
catalog may successfully use this request to delete a catalog* and to 
delete files with non.nuli passwords. 

The owner of a catalog and alternate users may us^ this request to 
delete all files to which they have bt^n granted control and read access 
permission* and are not required to share for modify* shorten* and 
^PP^n4m That is a share_mode of (read* execute) 

If d permanent file cycle is busy the file will be skipped. Busy 
Implies the file could not be accessed with an accass_mode of ir^Btl) and 
a sbare_mode of (read* execute)* Note* exclusive access required for 
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(modify* shorten* and append). 

If a file cycle is in use at the time of this subcommand the actual 
delete is not done until the last user detaches the file. 

If a master catalog Is specified on this subcommand* the master 
catalog will not be deleted* 

Previous EXCLUDE.CATALQG* EXCLUDER I LE* EXCLUD£_HXGHEST_CYCLES 
INCLUf>E_LARGE_CYCLES* INCLUDEJTYCLES and INCLUDE.ENPTY.CATALOGS 
subcommands may be used to specify a subset of the permanent files to be 
deleted. 

This subcommand is useful for the user to manage the users permanent 
file base. If files are being backed up prior to the 
OELETE.CATALOG.COHTENTS* the list file should be reviewed to insure the 
selected files were accessible. 

del eta.cataiog_contents catalog*<catalog> 

tstatus*<status_var I able! 

catalog 1 cs this parameter specifies the catalog name. 

status: See ERROR HANDLING, 

Bl.2.6 D£LET£_FILE.eONTENTS 1 OELETE.FILE^CONTENT I DELFC 

The purpose of this subcommand is to delete ail cycles of a file. 

This subcommand is intended to be as%4 by the user. The user must be 
permitted an access.moda of (control* read) and a share requirement that 
does not include (modify* %pp%n4$ or shorten) • 

If a permanent file cycle is busy it will be skipped. Busy implies a 
acc§ss_mode of read and a share_mode of (read* execute! may not be 
obtained. Note exclusive access for (modify* shorten* and append) is 
required. 

If the file is in use at the time of the delete the actual delete Is 
not done until the last user detaches the file. 

Previous EXCLUDE.FILE* EXCLU0E.HIGHEST.CYCLES* INCLUDE^LARGE.CYCLES* 
and INCLUDED YCLES subcommands may be used to specify a subset of the 
cycles to delete* 

delete.fi I e_con tents f i le*<per»anent_f II e> 

Cpassword*<name>3 
Cstatus*<status varlable>3 
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file I fi This parameter specifies the permanent file name* The 
cycle number » if specified* is ignored* 

password * pw* This parameter specifies the file password of the 

permanent file to be deleted* This must Match the password 

registered with the file* Omission will cause no password to 
be used. 

status* See ERROR HANDLING* 

81*2.? INCLUDE.USERS t INCLU0E_USE8 i INCU 

This subcommand is provided for the system operator* The purpose of 
this subcommand is to select a subrange of users or families to be 
backed up on subsequent BACKUP_ALt_FILES subcommand. This allows the 
Installation to organize their backup magnetic tapes onto several sets 
of tapes* This also allows multiple backups to occur s imul tanlously to 
improve peformance when multiple tape drives and controllers are 
available. If this subcommand is not used prior to the backup all files 
of alt users will be backed up* 

Another benefit of smaller sets of tapes Is restartabl I Ity* If the 
backup must be restarted for some reason* fewer tapes may need to be 
rewritten* 

The EXCLUDE.CATALOG and EXCLUDE.FILES subcommands take precedence 
over this command. 

Include_users users * list range of <catalog> or key all 
tstatus*<status variable>1 

users I user 1 u> This parameter specifies ^n alphabetic subrange 
of users to be backed up* If only a family name Is specified 
then all users in the family nre backed up* Examples *NV£ 
will backup all users In family NVE* If a family name is 
specified as the low value in a range then all users in the 
family up to the high value will be backed up* Examples users 
*sNVE«««NVE«€KB will backup all users up to and Including CK8* 
IF a family name is specified as the high value in a range 
then all users from low value to the end of the family 
specified by the high value will be backed up. Up to 20 
subranges may be specified* If the keyword All Is selected 
then the effect of any previous IHCLUO£_USER$ is undone* 

status: See ERROR HANDLING. 
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81.2.8 S0RTJJSER5 J SORU 

The purpose of this subcommand is to sort family and user names so 
that the backup will be performed in alphabetical order* This makes it 
easier to locate user on a backup listing* If this subcommand is not 
issued users nil I he backed up in the order they were created* 

This subcommand may precede a BACKUP..ALL.FILES or a DELETE. ALL.FILES 
subcommand* 

sort_users talphabetical_ord8r»<boolaan>1 
Cstatus*<status varlabie>3 

<ai phabetical_or ler I to* This parameter indicates whether the users 
are to be sorted or not on the backup* Omission will cause 
the users to be sorted. 

status* See ERROR HANDLING. 

81. 2. 9 EXCLUDE_CATALO$ ! EXCC 

The purpose of this subcommand is to direct subsequent backup 
subcommands to exclude the specified catalog from being backed up or 
deleted* The catalog nil I only be excluded if the subsequent backup 
subcommand Is at a higher level in the catalog tree* (closer to the 
root)* thus one may override the effects of this by explicitly backing 
up the catalog* or sjbcatalogs below the specified catalog* This 
subcommand takes precedence over all INCLUDE subcommands* 

This subcommand is useful for excluding files that are installed as 
part of the system initialization process* 

exclude_catalo j catalog«<catalog> 

£status*<status_variafe!e>l 

catalog 1 c* This parameter specifies the permanent file catalog 
that is to be excluded from being backed up. The catalog must 
exist* 

status* See ERROR HANDLING* 

Bl.2.10 EXCLUDE.FILE I EXCF 

The purpose of this subcommand Is to direct subsequent backup 
subcommands to exclude the permanent file or permanent file cycle 
specified from being backed yp or deleted. The file or cycle specified 
will only be excluded if the backup subcommand is at a higher level In 
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the catalog structure* (closer to the waster catalog). The effect of 
this subcommand may be overridden by explicitly backing up the permanent 
file or cycle* This subcommand has precedence over all INCLUDE 
subcommands* 

exclude_file f I I e*<permanent_f I le> 

Cstatus»<status_varifola>3 

file ! f* This parameter specifies the permanent file or the 
permanent file cycle which Is to be excluded from being backed 
up* The file must exist* 

status* See ERROR HANDLING* 

81.2*11 INCLUDE.CYCLES 5 INCC 

The purpose of this subcommand Is to direct subsequent backup 
subcommands to backup or delete cycles based on the creation* last 
access* last modification* or expiration date of the cycle* All catalog 
Information Is still backed up* If a ••before" criteria (created_bef ore* 
accessed_before# modi fi ad_bef ore* or expi red_before) is selected* then 
only cycles prior to the given date nil I be backed up* If an "after* 
criteria (created_after* accessed_af ter» modi f ied_after* expi red.af ter I 
Is selected then only cycles after the given date are backed up* 

Two INCLUD£_CYCLES directives may foe used to specify a window* Thus 
if one does IMCLUD£_CY€LES MODIFIE0_AFTER January 1 1983 followed by an 
INCLUOE.CTCLES HQDIFIED.SEFORE January 3 1983 then only cycles modified 
between the two dates specified will be backed up* 

Only one INCLUDE^CYCLES subcommand or two INCLUDE_CYCLE5 subcommands 
that specify a window may be used preceding a backup subcommand* 
CREATED.8EF0RE may be used with CREATED.AFTER. ACCESSED.BEFORE may be 
used with AC€ESSED_AFTER# MODXFXED.BEFQRE may be used with 
MDDXFXED^AFTER/ and EXPXRED_BEFORE may be used with EXPIRED.AFTER. 
Selection criteria may not be mixed* For example it is not allowable to 
MSB CREATED_BEFOR£ with EXPIRED.BEFQRE* 

The 1NCLUDE_€YCLES subcommand is Intended to provide a partial backup 
capability* An INCtyDE^CYCLES subcommand with a MQDIFIED^AFTER 
selection criteria preceding a BA€KUP_ALL_FILE5 subcommand backs up all 
catalog information* Cycle data Is backed up for files that have been 
modified after the specified date. The INCLUOE^CYCLES MODIFX£D_AFTER 
m4 MODZFXEO.BEFORE subcommands may be used to rebackup a window of 
partial backup dates* 

The XNCLUDE_€YCLES with an ACCES$ED_8EF0RE selection criteria 
followed by a BACKUP.ALL. FILES and a 0EL£TE_ALL.FXLES subcommands may be 
used to reduce the size of the permanent file base by deleting permanent 
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file cycles that have not h%*m accessed since the specified date and 

time. 

include.cycles select! on_cri ter la«key of cr eated_bef ore* 

cr eat ed_a ft er* 

accessed.bef ore* accessed_af ter* * 
mod if ied_bef ore* mod If led_af ter* 
explred_bef ore* explred_after* 
all 

month*! .. 12 J JANUARY i FEBRUARY 5 MARCH I APRIL t 
MAY S JUNE I JULY I AUGUST J SEPTEMBER I 
OCTOBER I NOVEMBER 5 DECEMBER 

day»l.*31 

year»1983**1999 

thour S0..231 

tiainute»®..59] 

Csecond*0..59 3 

Ciiilll lsecond*0..9991 

tstatus »<status_varl able>1 

$£LECTION_CRIT£RIA I SC» This parameter specifies the selection* 
criteria to be used In determining whether the data for a 
cycle Hill be backed up* This selection is based on 
statistics maintained in the permanent file catalog* 

created_before« Only cycles created before the given date* 
time Mill be backed up/deleted* 

created_afteri Only cycles created after the given date* time 
Mill be backed up/deleted* 

accessed_before* Only cycles whose last access was before the 
given date* time will be backed up/ deleted* 
accessed^afters Only cycles whose last access was after 
the given date and time will be backed up/deleted* 

modlf led^before* Only cycles which were last modified prior to 
the given date and time will be backed up/deleted* 

modlf led.afters Only cycles modified after the given date and 
time will be backed up/deleted* 

explred_befora* Only cycles with an expiration date before the 
given date will be Included.! If no date Is specified the 
current date is used* The retention period may be 
selected on the CREATE.FILE or CHANGE_CATALQG_£NTRY 
commands* 

expired^af ter * Only cycles whose expiration date Is after the 
specified date will be included* 
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all i This parameter undoes the effect of any previous 
INCLUDE.CYCLES subcommand* No date or time parameters 
may be specified with this selection* 

month • m* This parameter specifies the month* 

day I d* This parameter specifies the day of the month* 

year * y* This parameter specifies the year* 

The next three parameters specify time* Omission will cause the 
beginning of the day specified by month* day* and year to be used* 

hour * hr'» This parameter specifies hour* Omission will cause the 
beginning of day to be used* 

minute S mini This specifies minutes* Omission nil! cause zero to 
be used* 

second I sees This specifies seconds* Omission will cause zero to 
be used* 

millisecond 2 msec* This specifies milliseconds* Omission nil I 
cause zero to be used* 

status* See ERROR HANDLING* 

Example* INCLUOE^CYCLES HQDIFIED.AFTER January 1# 1984 

81.2*12 INCLUDE_£f1i>TY_€ATALQGS I INCEC 

The purpose of this subcommand is to direct subsequent 
DELETE_ALL_FILES or DELETE.CATALOG^CONTENTS subcommands to delete Cor 
not) any empty catalogs encountered* If this directive is not issued 
prior to a OELETE.ALL.FILES or 0ELETE_CATALOG_CGNT£NTS then empty 
catalogs will not be deleted* 

Include.empty. catalogs £delete.cata!og« <boolean>3 

£statu$*<status_varible>3 

deiete.catalog I delete.catalogs I dc* This parameter specifies 
whether any empty catalog encountered on subsequent 
OELETE^ALL^FILES or OELETE..CATAL0G.C0NTENTS should be deleted* 
Hester catalogs will not be deleted* Omission will cause TRUE 
to be used* 

status* See ERROR HANDLING. 
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81.2.13 EXCLUOE.HIGHEST.CYCLES J EXCLUDE_HIGHE5T_CYCLE 1 EXCHC 

The purpose of this subcommand Is to exclude the highest cycles of 
permanent files from being backed up/deleted on subsequent subcommands. 
This subcommand takes precedence over any INCLUOE.CYCLES subcommand. If 
this subcommand precede a backup or delete subcommand then the highest 
cycles of files are excluded. 

This command is useful by the insttl I ati on and the user to select 
files for backup and deletion. 

exclude.!)! ghest.cycles tnumber_of_cycies«0* .9993 

£status*<status variable>1 

nuiaber_of_cycles I noct This parameter specifies the number of high 
cycles to exclude. The range of this parameter is .. 999. 
Omission Mi 1 1 cause 3 to be used* 

status? See ERROR HANDLING. 

Bl.2.14 INCLUDE_VOLUMES ! IHCLUDE.VOLUME I IHCV 

The purpose of this subcommand is to specify that only permanent 
files residing on the included volumes will be backed up/deleted on 
subsequent backup subcommands. Any pre v I ou I y excluded files will not be 
Included regardless of device residence* All volumes specified must be 
currently active. 

This be subcommand may be useful In increasing the amount of 
available permanent space on a specific volume. Restoring the files 
Kill cause the files to be spr^9<i over all the volumes. 

incluc!e_vo!umes recorded.vsns* list of <strlng> ar key ail 

tstatus»<status varlable>l 

recorded_vsns ! recorded_vsn ! rvsn? This parameter specifies the 
volumes to Include. The recorded_vsn specified *hen the 
volume nas initialized must be provided. The recorded_vsn Is 
a string of up to six alphanumeric characters in uppercase. 
If keyword ALL is specified* then cycles **i 1 1 not be excluded 
based on device residence. 

status? See ERROR HANDLING. 

81.2.15 INCLUDE„LARG£_CY€LES S INCLC 

The purpose of this subcommand is to specify that subsequent 
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backup/delete subcommands should only include permanent file cycles 
whose size is greater than or equal to the given size* Any previously 
excluded cycle Mill not be hacked up/ deleted regardless of cycle size* 

This subcommand is useful when trying to reduce the amount of space 
used on mass storage* Deleting files that are small may cause the user 
a lot of trouble compared to the amount of space that may be obtained* 
Using this subcommand the installation may Ignore small files tihen 
reducing space* 

I n c I ude_ I a r ge.cy c I es mini mum.s i z e*< i n tege r> 

£status*<status varlabfe>1 

min1mum_size » ms* This parameter specifies the minimum size of 
files Included on subsequent backup/delete subcommands* 

status* See ERROR HANDLING* 

SI. 2. 16 S£T_LI$T.0!>TIfM$ 1 SET.LIST.QPTIGN I SETLO 

The purpose of this subcommand is to specify the information that 
Mill be displayed to the list file on subsequent subcommands* If the 
length of the display line selected is greater than the page width of 
the list file* additional lines will be used for the display* This 
directive does not affect the DISPLAY.BAC&UP.FILE subcommand* 

set.l 1 st.options Cf I le.displ ay.optlons* list of key account* a* 

project* p* all* none} 
Ccycle.display.optlofls* list of key 

creat ion.date.time* cdt* 
aceess.date.time* adt* 
modlf icatlon.date.time* mdt* 
explr at longdate* ed* 
access. count* ac* size* s* 
recorded.vsn* rvsn* 
global.fi le.name* gfn* 
ail* none! 
Cdlspiay.excluded.i tems»<boolean>3 
tstatus*<status var lable>3 

f I le.displ ay.options 3 f i le.display.optlon J fdos This parameter 
selects data to be displayed with the file name* Data that 
may be displayed Include the account and project* Omission 
will cause no data to be displayed* The following keywords 
are used to select displays* 

account * as Display the account name* 

project I pt Display the project name* 
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nones Only the file name is displayed* 

a! M Both the account and project name are displayed* 

cyole.display.optlons I cycle.display.opt Ion ! cdo* This parameter 
selects what information all! be displayed for each cycle 
backed up or restored on subsequent backup ^n4 restore 
subcommands. Additionally the cycle number and If the cycle 
was excluded will be displayed* The following options are 
aval I able* 

creation.date.tiae • cdt* The date and time the cycle was 
created is displayed* 

access.date.tlme S adt* The date and time the cycle was last 
accessed is displayed* 

mod if ication.date.time 5 ndti The date and time the cycle was 
last modified is displayed* 

expiration.date ! ad: The expiration date of the cycle is 
displayed* 

access. count » act The number of accesses to the cycle are 
displayed* 

size } s* The size of the cycle in bytes is displayed* 

recorded.vsn J rvsnt The disk volume that the start of the 
cycle resides on is displayed* 

global.fi le_.fi am e « gfn* The internally generated global file 
name generated when the cycle was created Is displayed* 
This name is not backed up or restored* 

none? Only the cycle number Is displayed* 

alls All options are displayed* 

Omission causes modification. date.tlme and sl*e to be 
displayed* 

d I sp I ay.exciuded.i tern ? dels If this is specified as TRUE* then the 
identification of all catalogs/ files or cycles excluded is 
displayed* If FALSE no excluded Items are displayed* 
Omission causes excluded Items to be displayed* 

status* See ERROR HANDLING* 



COMPANY PRIVATE - 



Bl-15 
SOFTWARE RELEASE BULLETIN 

84/03/12 

81.0 PERMANENT FILE HANAGEMENT 
81.2.17 QUIT ! QUI 



81,2.17 QUIT I QUI 

The purpose of this subcommand Is to terminate the current instance 
of execution of the backup permanent file utility. Control returns to 
the processor from which the BACKU^PERHAHEHT.FILE command Mas issued. 

quit 

81 . 3 R££IQ££-E£&MMEtiI-EXL£~i_££$£E 

The purpose of this command is to Initiate execution of the 
RESTORE. PERNANENT_FILE command utility. This utility restores permanent 
files and catalogs from backup copies created by the 
8ACKUP_PERNAN£NT_FILE utility. The restored information nil I look ^s it 
did when the backup occurred* Utility subcommands are used to direct 
the restore operation. 

restore_permanent_f i le £list»<file reference>3 

£status»<status variable>3 

list I If This parameter specifies the file to which a summary of 
the results of executing the restore utility are written* 
This includes a list of the names of all files and catalogs 
that were restored* Omission will cause $LIST to be used. 
Information to be listed may be selected by using the 
S£T_LI$T_GPTI0N5 subcommand. If the S£T„.LIST_GPTiaNS 
subcommand is not used modification date and time# and size 
will be displayed for each permanent file cycle. 

status* See ERROR HANDLING. 
81 . 4 ££SXQE£_££aMH£liI-£XL£-UIlLIIX-^£eMMaS 

The following subcommands are processed by the R£5TORE_P£RNANENT_FILE 
utility. 

81.4.1 REST0RE_ALL_FILE5 I RESAF 

The purpose of this subcommand is to restore all catalogs and all 
permanent flies on the specified backup file. Backup copies of catalogs 
and files that do not already exist on the online devices are restored. 
Catalogs and files that already exist are not altered. 

To restore the system when partial backups have been taken, this 
command is used to restore the last partial backup first. This has the 
effect of restoring the catalog structure as it was at the time of the 
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list partial backup. File cycle data which is not contained on the last 
partial backup is restored using the RE$TOR£_£X€LUD£0_FILE_CYCLE$ 

subcommand, 

restorers I l_f 1 las back up. f I le*<f I ie> 

Cstatus»<status var iable>1 

hackup_flla ! bf* This parameter specifies the file that contains 
the backup copies of the files and catalogs to be restored* 
The file is initially positioned to beginning of information* 

status t See ERROR HANDLING. 

81.4*2 RBSTaRE_EX€LU9E0_FIL£_CY€L£S J RESEFC 

The purpose of this subcommand is to rnstorm cycle data for files 
which are cataloged in the permanent file system but do not have data 
defined for them. These cycles must have been created by restoring them 
from a backup file for which cycle data Mas excluded by the 
IN€LUDE_€YCLES subcommand* The modification date on the backup file 
must match the modification date In the current catalog for the cycle 
data to be restored* If a cycle already has data defined* it Mill not 
be altered* 

This subcommand is to be used in restoring cycle data generated as a 
result of partial backups* If the permanent file system is backed up by 
a full backup followed by daily partial backup* then the last partial 
backup is restored with the RES?GRE_ALL_FILE$ subcommand* 
RE$TORE_ALL_FIL£$ restabii shes the catalog structure as It was at the 
time of the last partial backup* It restores file data that was 
Included on the partial backup file. File data for the rest of the 
files backed up by the full backup and previous partial backups are 
restored by using the R£STQR£_£XCLU0£D_FILE_CYCL£$ subcommand* This 
subcommand restores files by matching the modification date in the 
catalog with the modification date on the backup file* Using the 
procedure only flies that were in existence when the last partial backup 
was taken are restored* 

restore_axcluded_f i le.cycles £ f I le»<permanent_f i le> 3 

catalog*<catalog>3 
backup.fi I e*<f 1 ie> 
£new_name * 

<permaner*t flle> $ <catalog>3 
£status*<status varlab!e>1 

The first two parameters specify the catalog or file for which data 
is to be restored* Only one of the two may be specified* Omission of 
both will cause all data to be restored* In this case the new name 
parameter may not be specified* 
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last partial backup* File cycle data which is not contained on the last 
partial backup is restored using the RE$TOR£_£XCLUDEO_FILE_CYCLES 
subcommand. 

restore_al l_f I les backup_f lle*<f ile> 

£status*<status varlable>l 

backup.file ! bfs This par ameter sped fl es the file that contains 
the backup copies of the flies and catalogs to be restored* 
The file is initially positioned to beginning of information* 

status* See ERROR HANDLING* 

Bl.4.2 R£ST0RE_EX€LUDED_FIL£_CYCLE5 J RESEFC 

The purpose of this subcommand is to restore cycle data for files 
which are cataloged in the permanent file system but do not hn^te data 
defined for them. These cycles must have been created by restoring them 
from a backup file for which cycle data was excluded by the 
IR€LUDE_CYCLES subcommand* The modification date on the backup file 
must match the modification date in the current catalog for the cycle 
data to be restored* If a cycle already has data defined* it Mill not 
be altered* 

This subcommand is to be used In restoring cycle data generated as a 
result of partial backups* If the permanent file system is backed up by 
a full backup followed by daily partial backup* then the last partial 
backup is restored with the RE$?ORE_ALL_FILE$ subcommand* 
RE$TORE_ALL_FIL£$ restabilshes the catalog structure as It was at the 
time of the last partial backup* It restores file data that was 
Included on the partial backup file* File data for the rest of the 
files backed up by the full backup and previous partial backups are 
restored by using the R£$TORE_EXCLU0ED\_FIL£_CYCLE$ subcommand* This 
subcommand restores files by matching the modification date in the 
catalog with the modification date on the backup file* Using the 
procedure only files that were In existence when the last partial backup 
was taken are restored* 

restore_axcluded_f I le.cycles £ f i le a »<permafient - f i le> I 

catalog*<catalog>3 
backup_?i le*<f He> 
tnew_name * 

<permanent flle> 1 <catalog>] 
£status*<status variabie>3 

The first two parameters specify the catalog or file for which data 
is to be restored* Only one of the two may be specified* Omission of 
both will cause alt data to be restored* In this cast the new name 
parameter may not be specified* 
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file I f* This parameter specifies the permanent file or permanent 
file cycle on the backup file that is to he restored* If no 
cycle number is specified then data for all cycles of the file 
Mil) be restored* Cycle number if specified must be a 
specific cycle not SHIGH or SLOW* 

catalog S c* This parameter specifies the catalog as identified on 
the backup file* Data for all cycles in this catalog will be 
restored if a matching catalog entry exists with no data* 

backup.file * bf* This parameter specifies the file containing the 
backup information* This file is positioned at the beginning 
of Information* 

new_name ! nn l naw_f I le^name # nfn 5 new_catalog_name ! ncn* This 
parameter specifies a new name for the catalog file or cycle 
for which data is to be restored* This may be used if the 
name on the backup file Is different then that in the current 
permanent file system* Omission will cause the name as It 
exists on the backup file to be ust4* If a cycle reference 
was included on the file parameter but not on the new name 
parameter then SHIGH is used* In general this parameter 
should never have to be used by the installation or the user* 
It intent is to match the parameters on the RESTORE.CATALGG 
and RESTORE.FILE subcommands allowing change of catalog names 
to occur when working with partial backups* 

81*4.3 R£$TOR£_EXI$TING - .€ATALOG J RESEC 

The purpose of this subcommand is to restore an existing online 
catalog* Backup copies of files and tower level catal ogs/f lies that do 
not already exist in the specified online catalog are restored* Any 
item that exists online Is not altered. 

restore^existlng^catalog catalog*<catalog> 

backup.f i ie»<f I le> 
£new_catalog_name*<f i le>1 
£status»<status variableM 

catalog I c* This parameter specifies the catalog as identified on 
the backup file that Is the base for the restore* 

feackup„file » bf* This parameter specifies the file that contains 
the backup copy of the catalog and its associated files and 
subcatalogs/fi les* Information must have previously been 
written to this file by the BACKUf»_FILE# BACKU^ALL.FILES or 
SACKUP_€ATALOG subcommands* The file is positioned at 
beginning of information* 
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new.catalog.name J ncn: This parameter specifies the existing 
online catalog into which the flies and subcatalogs on the 
backup file are restored* Use of this parameter allows the 
contents of a catalog on the backup file to be restored in an 
online catalog with a different name* Omission will cause the 
name as it exists on the backup file to be used* 

status: See ERROR HANDLING. 

81.4.4 RESTORE.CATALOG J RESC 

The purpose of this subcommand is to restore a catalog that does not 
currently exist online* Backup copies of the catalog and all its 
associated files and subcatalogs are restored* Only a system operator 
or the owner of the resulting online catalog can request this function* 
The catalog can be restored with the name It had at the time it Mas 
backed up or under a n«H name. The resulting catalog must be unique 
relative to the catalog in which It Is registered. This command cannot 
be used to restore a user's master catalog. 

restore.catalog oatalog«<catalog> 

backup. f I le*<f 1 le> 
tnaw.eata I og_name*<cata I og>3 
£status»<status varlable>1 

catalog i c* This parameter specifies the catalog as Identified on 
the backup file that is the base for the restore. 

backup_.fi le » bft This parameter specifies the file containing 
backup information* It must have been previously written by 
the BACKUP.ALL.FILES or BACK UP .CAT A LOG subcommands* The file 
Is positioned at beginning of Information* 

new.eatalog.name 1 ncn? This p^rm^t^r specifies a new name for the 
catalog being restored* If this new name is not a unique name 
relative to the catalog in which it Is registered an error 
status Is returned* Omission will cause the name as it exists 
on the backup file to be used* 

status J See ERROR HANDLING* 

81*4.5 RESTORE.EXISTING.FILE I RESSF 

The purpose of this subcommand is to restore file cycles of %n 
existing online file. AH file cycles that exist on the backup file but 
that do not exist online are restored* Cycles that exist online are not 
altered. A user with cycle permission to the online file can request 
this function. 
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restore_existing_f i 1« f I le*<f i le> 

backup_f i le*<?l le> 
t password* <narae>l 
£new_f I le_name*<f I fe>l 
Cstatus*<status variable>3 

file i ft This parameter specifies the permanent file as identified 
on the backup file whose cycles are to be restored* If a 
cycle reference is included it is ignored* 

backup_flle J bfi This parameter specifies the file containing 
backup information* It must have previously been written by 
the BA€KUP„.RERHAN£NT_FILE utility* The file is positioned at 
beginning of information* 

password S pw* This parameter specifies the file password. It must 
match the existing file password* Omission Mill cause no 
password to be used* 

new_.f i le_name J nfn* This parameter specifies an existing online 
file to be restored* Use of this parameter allows a permanent 
file to be restored under a different file name than exists on 
the backup* If a cycle reference is included* it is ignored* 
Omission will cause the name as It exists on the backup file 
to be used* 

status t See ERROR HANOI IHG. 

81.4*6 R£STORE_FXLE i RESF 

The purpose of this subcommand Is to restore file cycles that do not 
currently exist online* If the file name includes a cycle reference 
only that cycle will be restored (at least one file cycle must exist}* 
If a cycle reference Is omitted ail file cycles will be restored Cthe 
file must not already exist). If Included It must specify a specific 
cycle number* $HIGH or $LQW cannot be used. The file can be restored 
with the name it had at the time it was backed up or under a new name. 
The resulting name must be unique relative to the catalog In which it Is 
registered. Only a user with cycle permission to the online catalog can 
restore all file cycles* Only a user with cycle permission to the file 
can restore an additional file cycle* 

restore_file flle»<file> 

baekup_f i I e«<f i 1 e> 
£ p as s wo r d»<n a me > 1 
Cnew_f 1 le_name«<f I le>l 
£status«<status variable>1 

file S f» This parameter specifies the permanent file as identified 
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on the backup file* 

backup.fi le J bfs This parameter specifies the file containing 
backup information* It must have been previously written by 
the 8ACKUP.ALL.FILES. BACKUP .CATALOG or 8ACKUP.FUE 
subcommands. The file is positioned at beginning of 
information* 

password J pw: This parameter specifies the file password* It must 
be provided If a specific cycle of an existing online file Is 
being restored* It must match the exstlng file password* 
Omission will cause no password to be used* 

new.fi le.natae J nfm This parameter specifies a new name for the 
file being restored* If a cycle reference Is not Included on 
this parameter* but was included on the file parameter then 
$NEXT will be used* If this name isn't a unique name relative 
to the catalog in which it is registered an error status is 
returned* Omission will cause the name as it exists on the 
backup file to be used* 

status? See ERROR HANDLING* 

Hl*4.7 SET.LIST.QPTIONS J SETLO 

This subcommand Is available as described In the backup section* 
81*4.8 0I$PLAY.8A€KUP_FILE I DIS8F 

The purpose of this subcommand is to display the contents of a backup 
file* Information is displayed about catalogs* files* and cycles which 
have bmn backed up onto the specified backup file* The caller may 
optionally select to display header Information maintained on the backup 
f I le# and may also direct the subcommand to attempt reading of all data 
on the backup file* The caller may compare this result with the backup 
listing to verify that everything backed up may be read successfully* 

This subcommand Is useful to the Installation and the user to 
determine exactly what Information is contained on a backup file* 

display.backup.fi le backup.fi le«<f lle> 

[display .opt! on* key Identifier* !• 

descriptor* 4* read.data* rd3 
Cnuaiber*<lnteger> or key alii 
Cstatus»<status variable>3 

backup.fl le 1 bf* This parameter specifies the file that contains 
the backup copies of the files and catalogs previously backed 
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up by a backup utility subcommand. 

display_optlon I do J This parameter specifies the level of 
information to be displayed* Valid specifications are* 

identifier I i* Selects a display of the name and type of each 
entry on the specified backup file. 

descriptor I d* Selects a display that includes* description 
of the record headers maintained on the backup file* the 
version of the backup permanent files utilities producing 
the backup filet The date and time the backup file was 
written* as Mel I as the backup_permanent„f I le subcommand 
producing the backup file* and for each cycle of each 
file on the backup file the following* cycle number* 
usage count* creation date and time* last access date and 
time* last modification date and time* expiration date* 
and cycle size* 

read_data J r^t In addition to the descriptor display an 
attempt Is made to read all data for each cycle on the 
backup file* The listing reports whether the data is 
read without error* No attempt is made to verify the 
data with the original file backed up* 

Omission wit! cause identifier to be used* 

number i n* This parameter selects the number of catalogs* files* 
or cycles from the beginning of the backup file* for which 
Information is to be displayed* If this parameter is omitted* 
or ALL is specified* then all entries on the backup file mrt 
displayed* 

status* See ERROR HANDLING. 

81*4.^ OUIT I QUI 

The purpose of this subcommand is to terminate the current instance 
of execution of the restore permanent file utility* Control returns to 
the processor from which the RESTORE. PERNANENT.FILE command was issued* 

<su 1 1 
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